NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #69 most downloaded on Packagist
Decouples applications from the system clock
Latest stable
v8.1.9
Last release 1 months ago
12 Oct 2026
Release timing varies
gaps range from 3 weeks to 10 months
Nearly every release is documented
notes for 39 of 39 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
62 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Changelog ( v8.1.9...v8.2.0-BETA1 )
Changelog (v8.1.9...v8.2.0-BETA1)
getTimestamp() and getMicrosecond() instead of formatting dates to read their timestamp (@nicolas-grekas)DateTimeImmutable::createFromTimestamp() to build dates from timestamps (@nicolas-grekas)# attribute to DatePoint (@jack-worman)bug #66833 Fix DatePoint being one hour off when its reference is in the DST fall-back hour ( @nicolas-grekas )
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Changelog (v8.1.0...v8.1.9)
DatePoint being one hour off when its reference is in the DST fall-back hour (@nicolas-grekas)DatePoint keeping the current time of day for dates with a relative part (@nicolas-grekas)new DatePoint() being one hour off during the DST fall-back hour (@nicolas-grekas)MockClock::sleep() with dates before 1970 (@nicolas-grekas)Changelog ( v8.1.0-BETA1...v8.1.0 )
Changelog (v8.1.0-BETA1...v8.1.0)
Changelog ( v8.0.0...v8.1.0-BETA1 )
Changelog (v8.0.0...v8.1.0-BETA1)
Changelog ( v8.0.7...v8.0.8 ) no significant changes
Changelog (v8.0.7...v8.0.8)
Changelog (https://github.com/symfony/clock/compare/v8.0.0-RC3...v8.0.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v8.0.0-RC3...v8.0.0)
bug symfony/symfony#62346 [Clock] Align MockClock::sleep() behavior with NativeClock for negative values (@yoeunes)
Changelog (https://github.com/symfony/clock/compare/v8.0.0-BETA2...v8.0.0-RC1)
feature symfony/symfony#60639 Bump Symfony 8 to PHP >= 8.4 (@nicolas-grekas)
Changelog (https://github.com/symfony/clock/compare/v7.3.4...v8.0.0-BETA1)
bug #66833 Fix DatePoint being one hour off when its reference is in the DST fall-back hour ( @nicolas-grekas )
Changelog (v7.4.9...v7.4.21)
DatePoint being one hour off when its reference is in the DST fall-back hour (@nicolas-grekas)DatePoint keeping the current time of day for dates with a relative part (@nicolas-grekas)new DatePoint() being one hour off during the DST fall-back hour (@nicolas-grekas)MockClock::sleep() with dates before 1970 (@nicolas-grekas)Changelog ( v7.4.7...v7.4.8 ) no significant changes
Changelog (v7.4.7...v7.4.8)
Changelog (https://github.com/symfony/clock/compare/v7.4.0-RC3...v7.4.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.4.0-RC3...v7.4.0)
bug symfony/symfony#62346 [Clock] Align MockClock::sleep() behavior with NativeClock for negative values (@yoeunes)
Changelog (https://github.com/symfony/clock/compare/v7.4.0-BETA2...v7.4.0-RC1)
Changelog (https://github.com/symfony/clock/compare/v7.3.4...v7.4.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.3.4...v7.4.0-BETA1)
bug symfony/symfony#62346 [Clock] Align MockClock::sleep() behavior with NativeClock for negative values ( @yoeunes )
Changelog (v7.3.7...v7.3.8)
Changelog (https://github.com/symfony/clock/compare/v7.3.0-RC1...v7.3.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.3.0-RC1...v7.3.0)
Changelog (https://github.com/symfony/clock/compare/v7.3.0-BETA2...v7.3.0-RC1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.3.0-BETA2...v7.3.0-RC1)
Changelog (https://github.com/symfony/clock/compare/v7.2.6...v7.3.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.2.6...v7.3.0-BETA1)
Changelog (https://github.com/symfony/clock/compare/v7.2.0-RC1...v7.2.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.2.0-RC1...v7.2.0)
Changelog (https://github.com/symfony/clock/compare/v7.2.0-BETA2...v7.2.0-RC1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.2.0-BETA2...v7.2.0-RC1)
Changelog (https://github.com/symfony/clock/compare/v7.1.6...v7.2.0-BETA1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.1.6...v7.2.0-BETA1)
Changelog (https://github.com/symfony/clock/compare/v7.1.5...v7.1.6) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.1.5...v7.1.6)
Changelog (https://github.com/symfony/clock/compare/v7.1.0...v7.1.1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.1.0...v7.1.1)
Changelog (https://github.com/symfony/clock/compare/v7.1.0-RC1...v7.1.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.1.0-RC1...v7.1.0)
DatePoint::getMicrosecond() and DatePoint::setMicrosecond()Changelog (https://github.com/symfony/clock/compare/v7.1.0-BETA1...v7.1.0-RC1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.1.0-BETA1...v7.1.0-RC1)
feature symfony/symfony#54442 [Clock] Add a polyfill for DateTimeImmutable::createFromTimestamp() (@derrabus)
Changelog (https://github.com/symfony/clock/compare/v7.0.7...v7.1.0-BETA1)
Changelog (https://github.com/symfony/clock/compare/v7.0.7...v7.0.8) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.0.7...v7.0.8)
bug symfony/symfony#54530 [Clock] initialize the current time with midnight before modifying the date (@xabbuh)
Changelog (https://github.com/symfony/clock/compare/v7.0.6...v7.0.7)
bug symfony/symfony#54129 [Clock] Add attributes to support PHPUnit 10 + 11 (@ruudk)
Changelog (https://github.com/symfony/clock/compare/v7.0.4...v7.0.5)
Changelog (https://github.com/symfony/clock/compare/v7.0.2...v7.0.3) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.0.2...v7.0.3)
Changelog (https://github.com/symfony/clock/compare/v7.0.1...v7.0.2) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.0.1...v7.0.2)
Changelog (https://github.com/symfony/clock/compare/v7.0.0-RC2...v7.0.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.0.0-RC2...v7.0.0)
Changelog (https://github.com/symfony/clock/compare/v7.0.0-RC1...v7.0.0-RC2) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.0.0-RC1...v7.0.0-RC2)
Changelog (https://github.com/symfony/clock/compare/v7.0.0-BETA3...v7.0.0-RC1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v7.0.0-BETA3...v7.0.0-RC1)
feature symfony/symfony#51415 [Clock] Add DatePoint: an immutable DateTime implementation with stricter error handling and return types (@nicolas-grek
Changelog (https://github.com/symfony/clock/compare/v6.3.6...v7.0.0-BETA1)
DatePoint: an immutable DateTime implementation with stricter error handling and return types (@nicolas-grekas)DateMalformedStringException/DateInvalidTimeZoneException when appropriate (@nicolas-grekas)Changelog ( v6.4.30...v6.4.48 )
Changelog (v6.4.30...v6.4.48)
DatePoint being one hour off when its reference is in the DST fall-back hour (@nicolas-grekas)DatePoint keeping the current time of day for dates with a relative part (@nicolas-grekas)new DatePoint() being one hour off during the DST fall-back hour (@nicolas-grekas)MockClock::sleep() with dates before 1970 (@nicolas-grekas)Changelog ( v6.4.29...v6.4.30 )
Changelog (v6.4.29...v6.4.30)
Changelog (https://github.com/symfony/clock/compare/v6.4.23...v6.4.24) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.23...v6.4.24)
Changelog (https://github.com/symfony/clock/compare/v6.4.12...v6.4.13) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.12...v6.4.13)
Changelog (https://github.com/symfony/clock/compare/v6.4.7...v6.4.8) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.7...v6.4.8)
bug symfony/symfony#54530 [Clock] initialize the current time with midnight before modifying the date (@xabbuh)
Changelog (https://github.com/symfony/clock/compare/v6.4.6...v6.4.7)
bug symfony/symfony#54129 [Clock] Add attributes to support PHPUnit 10 + 11 (@ruudk)
Changelog (https://github.com/symfony/clock/compare/v6.4.4...v6.4.5)
Changelog (https://github.com/symfony/clock/compare/v6.4.2...v6.4.3) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.2...v6.4.3)
Changelog (https://github.com/symfony/clock/compare/v6.4.1...v6.4.2) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.1...v6.4.2)
Changelog (https://github.com/symfony/clock/compare/v6.4.0-RC2...v6.4.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.0-RC2...v6.4.0)
DatePoint: an immutable DateTime implementation with stricter error handling and return typesDateMalformedStringException/DateInvalidTimeZoneException when appropriate$modifier argument to the now() helperChangelog (https://github.com/symfony/clock/compare/v6.4.0-BETA3...v6.4.0-RC1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.4.0-BETA3...v6.4.0-RC1)
feature symfony/symfony#51415 [Clock] Add DatePoint: an immutable DateTime implementation with stricter error handling and return types (@nicolas-grek
Changelog (https://github.com/symfony/clock/compare/v6.3.6...v6.4.0-BETA1)
DatePoint: an immutable DateTime implementation with stricter error handling and return types (@nicolas-grekas)DateMalformedStringException/DateInvalidTimeZoneException when appropriate (@nicolas-grekas)Changelog (https://github.com/symfony/clock/compare/v6.3.11...v6.3.12) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.3.11...v6.3.12)
Changelog (https://github.com/symfony/clock/compare/v6.3.10...v6.3.11) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.3.10...v6.3.11)
bug symfony/symfony#51190 [Clock] load function only if not loaded before (@xabbuh)
Changelog (https://github.com/symfony/clock/compare/v6.3.3...v6.3.4)
bug symfony/symfony#50611 [Clock] Fix MockClock::modify() on PHP 8.3 (@nicolas-grekas)
Changelog (https://github.com/symfony/clock/compare/v6.3.0...v6.3.1)
Changelog (https://github.com/symfony/clock/compare/v6.3.0-RC2...v6.3.0) *
Changelog (https://github.com/symfony/clock/compare/v6.3.0-RC2...v6.3.0)
ClockAwareTrait to help write time-sensitive classesClock class and now() functionChangelog (https://github.com/symfony/clock/compare/v6.3.0-BETA3...v6.3.0-RC1) *
Changelog (https://github.com/symfony/clock/compare/v6.3.0-BETA3...v6.3.0-RC1)
feature symfony/symfony#49442 [TwigBundle] Add alias deprecation for Twig_Environment (@94noni)
Changelog (https://github.com/symfony/clock/compare/v6.2.10...v6.3.0-BETA1)
placeholder_attr option (@elementaire)ErrorHandler on boot (@HypeMC)NoSuspiciousCharacters constraint to validate a string is not suspicious (@MatTheCat)BatchHandlerTrait with getBatchSize() (@alexandre-daubois)Twig_Environment (@94noni)enum expression function (@alexandre-daubois)notifier.logger_notification_listener to notifier.notification_logger_listener (@ker0x)enum_exists mock (@alexandre-daubois)extra attribute for HttpClient Configuration (@voodooism)#[WithLogLevel] for setting custom log level for exceptions (@angelov)TaggedIteratorArgument (@chalasr)getConstraint() method to ConstraintViolationInterface (@syl20b)EmojiTransliterator (@fancyweb)Clock class and now() function (@nicolas-grekas)assertSelectorCount (@curlycarla2004)env and param parameters for Autowire attribute (@alexndlm)bug symfony/symfony#50611 [Clock] Fix MockClock::modify() on PHP 8.3 (@nicolas-grekas)
Changelog (https://github.com/symfony/clock/compare/v6.2.11...v6.2.12)
Changelog (https://github.com/symfony/clock/compare/v6.2.6...v6.2.7) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.2.6...v6.2.7)
Changelog (https://github.com/symfony/clock/compare/v6.2.4...v6.2.5) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.2.4...v6.2.5)
bug #48538 Fix usleep deprecation warning (victor-prdh)
Changelog (https://github.com/symfony/clock/compare/v6.2.1...v6.2.2)
usleep deprecation warning (victor-prdh)Changelog (https://github.com/symfony/clock/compare/v6.2.0-RC2...v6.2.0) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.2.0-RC2...v6.2.0)
bug #48320 Implement PSR-20 (nicolas-grekas)
Changelog (https://github.com/symfony/clock/compare/v6.2.0-RC1...v6.2.0-RC2)
Changelog (https://github.com/symfony/clock/compare/v6.2.0-BETA3...v6.2.0-RC1) * no significant changes
Changelog (https://github.com/symfony/clock/compare/v6.2.0-BETA3...v6.2.0-RC1)
One column per quarter.