dcarbone/gotime

Golang-like time class(es) for PHP 7.0+

gotime

Golang-like time class(es) for PHP 7.3+, _(*1)

, _(*2)

Desc

The goal of this lib is to achieve near-enough (as determined by me) api equivalency in PHP to the GoLang Time package, as basically it is just better than PHP's., _(*3)

Classes

Duration

The Duration class is designed to emulate the golang time.Duration type., _(*4)

There are 2 ways to construct a Duration class:, _(*5)

use \DCarbone\Go\Time;

$d = new Time\Duration(5 * Time::Second);
// produces a Duration with an internal value of 5e9;

$d = Time::ParseDuration('5s');
// produces a Duration with an internal value of 5e9;

Internally the "duration" is represented as an integer, allow for much fun., _(*6)

Serialization

Assuming $dt = new Time\Duration(5 * Time::Second);:, _(*7)

DateInterval

DateInterval pretty much sucks. I have created my own DateInterval and IntervalSpec classes to help alleviate this., _(*8)

These provide Duration the ability to create an interval for use with the standard DateTime::add and DateTime::sub methods as such:, _(*9)

$dt = new \DateTime();
echo "{$dt->format('H:i:s')}\n";

$d = new Time\Duration(5 * Time::Second);
$dt->add($d->DateInterval());
echo "{$dt->format('H:i:s')}\n";

// 16:03:37
// 16:03:42

Time

The Time class is designed to BARELY emulate the golang time.Time type. It's basically DateTime with stuff on it. I consider it to be in a "beta" state., _(*10)

There are 2 basic ways to construct a Time class:, _(*11)

use DCarbone\Go\Time;

// Returns an instance of Time\Time with an internal time of the unix epoch 
$t = Time::New();

// Returns an instance of Time\Time with an internal time of whenever you constructed it. 
$t = Time::Now();