symfony/clock

Decouples applications from the system clock

v8.0.0-BETA1 2025-08-04 07:36 UTC

Requires

• php: >=8.4
• psr/clock: ^1.0

Provides

• psr/clock-implementation: 1.0

MIT

• Nicolas Grekas
• Symfony Community

• time
• clock
• psr20

README

Symfony Clock decouples applications from the system clock.

Getting Started

composer require symfony/clock

use Symfony\Component\Clock\NativeClock;
use Symfony\Component\Clock\ClockInterface;

class MyClockSensitiveClass
{
    public function __construct(
        private ClockInterface $clock,
    ) {
        // Only if you need to force a timezone:
        //$this->clock = $clock->withTimeZone('UTC');
    }

    public function doSomething()
    {
        $now = $this->clock->now();
        // [...] do something with $now, which is a \DateTimeImmutable object

        $this->clock->sleep(2.5); // Pause execution for 2.5 seconds
    }
}

$clock = new NativeClock();
$service = new MyClockSensitiveClass($clock);
$service->doSomething();

Resources

• Documentation
• Contributing
• Report issues and send Pull Requests in the main Symfony repository