// Via global clock $now = Clock::get()->now();

// Via helper function $now = now(); $later = now('+3 hours');


### Using in Services (ClockAwareTrait)

```php
use Symfony\Component\Clock\ClockAwareTrait;

class MyService
{
    use ClockAwareTrait;

    public function isExpired(\DateTimeInterface $until): bool
    {
        return $this->now() > $until;
    }
}

Constructor Injection

use Symfony\Component\Clock\ClockInterface;

class ExpirationChecker
{
    public function __construct(private ClockInterface $clock) {}

    public function isExpired(\DateTimeInterface $until): bool
    {
        return $this->clock->now() > $until;
    }
}

Testing with MockClock

use Symfony\Component\Clock\MockClock;

$clock = new MockClock('2024-01-15 10:00:00');
$clock->sleep(600);        // Advance 600 seconds instantly
$clock->modify('+1 hour'); // Advance by modifier

Testing with ClockSensitiveTrait

use Symfony\Component\Clock\Test\ClockSensitiveTrait;

class MyTest extends TestCase
{
    use ClockSensitiveTrait;

    public function testTime(): void
    {
        $clock = static::mockTime('2024-01-15 10:00:00');
        $service = new MyService();
        $service->setClock($clock);
        // assertions...
    }
}

DatePoint

use Symfony\Component\Clock\DatePoint;

$dp = new DatePoint();                          // now
$dp = new DatePoint('+1 month');                // relative
$dp = DatePoint::createFromTimestamp(1700000000); // from timestamp

Doctrine Types (Symfony 7.3+)

Type	Extends	Since
`date_point`	`datetime_immutable`	7.3
`day_point`	`date_immutable`	7.4
`time_point`	`time_immutable`	7.4

Full Documentation

For complete details including all clock implementations (NativeClock, MonotonicClock), DatePoint methods, Doctrine entity examples, exception handling, and advanced testing patterns, see references/clock.md.

symfony-7-4-clock

Symfony 7.4 Clock Component

Quick Reference

Installation

Getting Current Time