symfony/clock

Decouples applications from the system clock

Maintainers

Details

github.com/symfony/clock

Homepage

Source

Fund package maintenance!
fabpot
Tidelift
symfony.com/sponsor

Installs: 43 537 005

Dependents: 68

Suggesters: 2

Security: 0

Stars: 310

Watchers: 5

Forks: 4

v7.2.0-BETA1 2024-09-25 14:21 UTC

Requires

Provides

MIT b81435fbd6648ea425d1ee96a2d8e68f4ceacd24

timeclockpsr20

This package is auto-updated.

Last update: 2024-10-27 15:25:19 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();

Resources