OffsetClock — offset clock

Purpose

Decorator: “time travel” relative to the inner clock by a fixed offset (seconds or DateInterval, any sign).

Staging “in the future” (promo/deadline testing), compensating skew with an external system: OffsetClock::aheadBy($clock, 3600.0).

$tomorrow = OffsetClock::aheadBy(SystemClock::utc(), 86_400.0);
$yesterday = OffsetClock::behindBy(SystemClock::utc(), new DateInterval('P1D'));

Not for test determinism — time still flows inside; use FrozenClock/MockClock in tests.

flowchart LR
    A[Inner clock] -->|now()| B[OffsetClock]
    B -->|+offset| C[Shifted moment]
    C --> D[Consumer]

Aspect	🏆 CloudCastle	symfony	carbon	lcobucci	beste	ergebnis
Offset as a decorator without global state	✅	❌	❌	❌	❌	❌
Interval or seconds, any sign	✅	❌	❌	❌	❌	❌
Output timezone override	✅	❌	❌	❌	❌	❌
Composes with any package clock	✅	❌	❌	❌	❌	❌
Total	🏆 4	0	0	0	0	0