Skip to content
/ gotime Public
forked from dcarbone/gotime

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

License

Notifications You must be signed in to change notification settings

slt/gotime

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gotime

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

Build Status

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);:

Type Exec Output
JSON echo json_encode($dt); 5000000000
string echo (string)$dt; 5s;

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();

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%