dcarbone / gotime
Golang-like time class(es) for PHP 8.0+
Installs: 93 016
Dependents: 4
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- php: ^8.0
- ext-json: *
Requires (Dev)
- phpunit/phpunit: ^9.5
README
Golang-like time class(es) for PHP 7.3+
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.
Classes
Duration
The Duration class is designed to emulate the golang time.Duration type.
There are 2 ways to construct a Duration class:
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.
Serialization
Assuming $dt = new Time\Duration(5 * Time::Second);
:
DateInterval
DateInterval pretty much sucks. I have created my own DateInterval and IntervalSpec classes to help alleviate this.
These provide Duration the ability to create an interval for use with the standard DateTime::add and DateTime::sub methods as such:
$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.
There are 2 basic ways to construct a Time class:
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();