README

Provides enhanced DateTime and DateInterval objects with clock abstraction

• based on DateTimeImmutable object (to discourage the use of mutable version)
• provides SystemClock for production and FrozenClock for testing
• provides extra static factory methods: now() (uses clock), fromString(), fromTimestamp(), fromFloatTimestamp()
• implements Stringable and JsonSerializable with implicit conversion to string (ISO 8601)

Examples

use Pauci\DateTime\DateTime;

$now = $clock->now();
// or
DateTime::setClock($clock);
$now = DateTime::now();

echo $now;                                            // 2016-05-20T14:30:54.345678+02:00
echo json_encode($now);                               // "2016-05-20T14:30:54.345678+02:00"
echo DateTime::fromTimestamp(1512148033);             // 2017-12-01T18:07:13+01:00
echo DateTime::fromFloatTimestamp(1512148033.000005); // 2017-12-01T18:07:13.000005+01:00

DateTime::setFormat('Y-m-d H:i:s');
echo $now;                                            // 2016-05-20 14:30:54
echo json_encode($now);                               // "2016-05-20 14:30:54"