symfony/clock

Decouples applications from the system clock

Maintainers

Package info

github.com/symfony/clock

Homepage

pkg:composer/symfony/clock

Fund package maintenance!

fabpot

nicolas-grekas

symfony.com/sponsor

Tidelift

Statistics

Installs: 198 228 967

Dependents: 196

Suggesters: 4

Stars: 433

Security

Advisories: 0

Aikido package health analysis

v8.1.0 2026-05-29 05:06 UTC

Requires

Provides

MIT 701ef4de9705d6c32292ebee5e8044094a09fbf6

timeclockpsr20

This package is auto-updated.

Last update: 2026-06-05 06:51:00 UTC

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

Sponsor

This package is looking for a backer.

Help Symfony by sponsoring its development!

Resources