Enhanced DateTime, DateTimeImmutable and DateInterval objects

v0.7.0 2023-01-18 12:28 UTC


Source Code PHP Latest Version Build Status Coverage Status Software License Total Downloads

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)


use Pauci\DateTime\DateTime;

$now = $clock->now();
// or
$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"