This package provides a simple abstraction of a clock, following the suggestion by Martin Fowler, and compatible with PSR-20.

Run

composer require ergebnis/clock

Create a new system clock and use it to determine the current time:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$timeZone = new \DateTimeZone('Europe/Berlin');

$clock = new Clock\SystemClock($timeZone);

$now = $clock->now();

Create a new frozen clock and use it in tests:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$now = new \DateTimeImmutable();

$clock = new Clock\FrozenClock($now);

sleep(5);

$stillNow = $clock->now();

Alternatively, create a new frozen clock by freezing a system clock:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$timeZone = new \DateTimeZone('Europe/Berlin');

$clock = new Clock\SystemClock($timeZone);

$frozenClock = $clock->freeze();

$now = $clock->now();

sleep(5);

$stillNow = $clock->now();

The maintainers of this package record notable changes to this project in a changelog.

The maintainers of this package suggest following the contribution guide.

The maintainers of this package ask contributors to follow the code of conduct.

The maintainers of this package provide limited support.

You can support the maintenance of this package by sponsoring @localheinz or requesting an invoice for services related to this package.

This package supports PHP versions with active support.

The maintainers of this package add support for a PHP version following its initial release and drop support for a PHP version when it has reached its end of active support.

This package has a security policy.

This package uses the MIT license.

This package is inspired by lcobucci/clock (originally licensed under MIT by Luís Cobucci).

Follow @localheinz and @ergebnis on Twitter.