localheinz / clock

2.13.0 2026-09-24 19:41 UTC

Requires

• php: ~7.4.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0 || ~8.6.0
• psr/clock: ^1.0.0

Requires (Dev)

• ergebnis/composer-normalize: ^2.53.0
• ergebnis/license: ^2.7.0
• ergebnis/php-cs-fixer-config: ^6.63.2
• ergebnis/rector-rules: ^1.18.3
• infection/infection: ~0.26.6
• phpstan/extension-installer: ^1.4.3
• phpstan/phpstan: ^2.2.14
• phpstan/phpstan-deprecation-rules: ^2.0.5
• phpstan/phpstan-phpunit: ^2.0.18
• phpstan/phpstan-strict-rules: ^2.0.12
• phpunit/phpunit: ^9.6.34
• rector/rector: ^2.6.1

Provides

• psr/clock-implementation: 1.0.0

MIT

• Andreas Möller

• clock
• system-clock
• test-clock

Published on Packagist.org on 2026-09-24 19:41 UTC

README

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

Installation

Run

composer require ergebnis/clock

Usage

SystemClock

Create a new SystemClock and use it to determine the current time in a specific time zone:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$clock = new Clock\SystemClock(new \DateTimeZone('Europe/Berlin'));

$now = $clock->now();

Freeze a SystemClock to turn it into a FrozenClock:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$clock = new Clock\SystemClock(new \DateTimeZone('Europe/Berlin'));

$frozenClock = $clock->freeze();

$now = $clock->now();

sleep(5);

$stillNow = $clock->now();

UtcClock

Create a new UtcClock and use it to determine the current time in the UTC time zone:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$clock = new Clock\UtcClock();

$now = $clock->now();

Freeze a UtcClock to turn it into a FrozenClock:

<?php

declare(strict_types=1);

use Ergebnis\Clock;

$clock = new Clock\UtcClock();

$frozenClock = $clock->freeze();

$now = $clock->now();

sleep(5);

$stillNow = $clock->now();

FrozenClock

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

Changelog

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

Contributing

The maintainers of this project suggest following the contribution guide.

Code of Conduct

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

General Support Policy

The maintainers of this project provide limited support.

PHP Version Support Policy

This project currently supports the following PHP versions:

• PHP 7.4 (has reached its end of life on November 28, 2022)
• PHP 8.0 (has reached its end of life on November 26, 2023)
• PHP 8.1 (has reached its end of life on December 31, 2025)
• PHP 8.2
• PHP 8.3
• PHP 8.4
• PHP 8.5

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

Security Policy

This project has a security policy.

License

This project uses the MIT license.

Credits

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

Social

Follow @localheinz and @ergebnis on Twitter.