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: 15 710 882

Dependents: 54

Suggesters: 1

Security: 0

Stars: 242

Watchers: 5

Forks: 3

v7.0.7 2024-04-18 09:29 UTC

Requires

Provides

MIT 2008671acb4a30b01c453de193cf9c80549ebda6

timeclockpsr20

This package is auto-updated.

Last update: 2024-04-29 12:33:32 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