Chronos Laravel Package

Improvements

• Added DST-safe elapsed time arithmetic methods that use Unix timestamp manipulation instead of wall clock time:

  • addElapsedHours() / subElapsedHours()
  • addElapsedMinutes() / subElapsedMinutes()
  • addElapsedSeconds() / subElapsedSeconds()

  These methods ensure correct behavior across DST transitions and are true inverses of diffInHours(), diffInMinutes(), and diffInSeconds().

Full Changelog: https://github.com/cakephp/chronos/compare/3.4.0...3.5.0

What's Changed

• Add withTestNow() for scoped time mocking by @dereuromark in https://github.com/cakephp/chronos/pull/498
• Add startOfHour() and endOfHour() methods to ChronosTime by @dereuromark in https://github.com/cakephp/chronos/pull/508
• Add shiftTimezone() method to Chronos by @dereuromark in https://github.com/cakephp/chronos/pull/507
• Add toArray() method to Chronos, ChronosDate, and ChronosTime by @dereuromark in https://github.com/cakephp/chronos/pull/506
• Add time comparison methods to ChronosTime by @dereuromark in https://github.com/cakephp/chronos/pull/505
• Add nextOccurrenceOf() and previousOccurrenceOf() methods by @dereuromark in https://github.com/cakephp/chronos/pull/496

Full Changelog: https://github.com/cakephp/chronos/compare/3.3.3...3.4.0

What's Changed

Bug Fixes

• Fix regression in 3.3.2: createFromFormat() with Unix timestamp format ('U') incorrectly applying testNow, reverted due to BC break - https://github.com/cakephp/chronos/pull/503

Full Changelog: https://github.com/cakephp/chronos/compare/3.3.2...3.3.3

What's Changed

Bug Fixes

• Fix createFromFormat to respect setTestNow for missing components by @dereuromark in https://github.com/cakephp/chronos/pull/494
• Prevent infinite loops from zero-interval DatePeriods by @dereuromark in https://github.com/cakephp/chronos/pull/499

Full Changelog: https://github.com/cakephp/chronos/compare/3.3.1...3.3.2

What's Changed

• Use match() instead of switch/case. by @ADmad in https://github.com/cakephp/chronos/pull/487

Full Changelog: https://github.com/cakephp/chronos/compare/3.3.0...3.3.1

What's Changed

• Split out toQuarterRange() for cleaner return API. by @dereuromark in https://github.com/cakephp/chronos/pull/479
• Add toRfc7231String() helper by @othercorey in https://github.com/cakephp/chronos/pull/484

Full Changelog: https://github.com/cakephp/chronos/compare/3.2.0...3.3.0

What's Changed

• Fix createFromTimestamp() deprecation message by @othercorey in https://github.com/cakephp/chronos/pull/485

Full Changelog: https://github.com/cakephp/chronos/compare/2.5.1...2.5.2

What's Changed

• Add ChronosPeriod which returns Chronos instances from DatePeriod by @othercorey in https://github.com/cakephp/chronos/pull/472
• Add ChronosDatePeriod which returns ChronosDate instances from DatePeriod by @othercorey in https://github.com/cakephp/chronos/pull/476

New Contributors

• @MolbioUnige made their first contribution in https://github.com/cakephp/chronos/pull/462

Full Changelog: https://github.com/cakephp/chronos/compare/3.1.0...3.2.0

This release requires PHP 8.4 to match the signature of DateTimeImmutable::createFromTimestamp(). Users not running PHP 8.4+ do not need this version.

What's Changed

• Allow float timestamp for createFromTimestamp() to match php by @othercorey in https://github.com/cakephp/chronos/pull/474
• Require PHP 8.4 for createFromTimestamp() siganture by @othercorey in https://github.com/cakephp/chronos/pull/475

Full Changelog: https://github.com/cakephp/chronos/compare/2.4.5...2.5.1

What's Changed

• Added replacement suggestions for some deprecated functions by @Staubiii in https://github.com/cakephp/chronos/pull/458
• Fix deprecations from internals for Date by @markstory in https://github.com/cakephp/chronos/pull/459
• Fix wrong return types by @Harfusha in https://github.com/cakephp/chronos/pull/460

New Contributors

• @Apisathan made their first contribution in https://github.com/cakephp/chronos/pull/450
• @Staubiii made their first contribution in https://github.com/cakephp/chronos/pull/458
• @Harfusha made their first contribution in https://github.com/cakephp/chronos/pull/460

Full Changelog: https://github.com/cakephp/chronos/compare/2.4.4...2.4.5

Behavior Changes

• Chronos::createFromTimestamp()handles timezones differently. If $timezone is not explicitly passed then the instance has timezone set to +00:00 unlike earlier where the currently set default timezone was used. This behavior change normalizes behavior with changes in PHP 8.4 which adds a new DateTimeInterface::createFromTimestamp() method.

What's Changed

• Improve exception messages by @dereuromark in https://github.com/cakephp/chronos/pull/447
• Pluralize years and months in function by @andrewlavens in https://github.com/cakephp/chronos/pull/448
• Provide PSR-20 Clock implementation by @odan in https://github.com/cakephp/chronos/pull/443
• Run composer normalize over composer.json by @dereuromark in https://github.com/cakephp/chronos/pull/449
• Allow phpunit 11 by @ADmad in https://github.com/cakephp/chronos/pull/455
• Fix error on PHP 8.4 by @ADmad in https://github.com/cakephp/chronos/pull/454

New Contributors

• @andrewlavens made their first contribution in https://github.com/cakephp/chronos/pull/448

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.4...3.1.0

What's Changed

• Fix off by one errors in diffFiltered by @markstory in https://github.com/cakephp/chronos/pull/446

Full Changelog: https://github.com/cakephp/chronos/compare/2.4.3...2.4.4

What's Changed

• Add ChronosTime::endOfDay() by @othercorey in https://github.com/cakephp/chronos/pull/439
• Add microseconds to Chronos::endOfDay() by @othercorey in https://github.com/cakephp/chronos/pull/441

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.3...3.0.4

What's Changed

• Add microseconds to Chronos::endOfDay() by @othercorey in https://github.com/cakephp/chronos/pull/440
• Use ChronosDate in docs by @othercorey in https://github.com/cakephp/chronos/pull/438

Full Changelog: https://github.com/cakephp/chronos/compare/2.4.2...2.4.3

What's Changed

• Fix "undefined array key" error. by @ADmad in https://github.com/cakephp/chronos/pull/415
• Use phive to install phpstan by @markstory in https://github.com/cakephp/chronos/pull/436
• Restore Date::create() compatibility with no params by @markstory in https://github.com/cakephp/chronos/pull/435

Full Changelog: https://github.com/cakephp/chronos/compare/2.4.1...2.4.2

What's Changed

• Restore Chronos::toNative() by @markstory in https://github.com/cakephp/chronos/pull/433

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.2...3.0.3

Summary

The Chronos class once again extends DateTimeImmutable and therefore implements DateTimeInterface. ChronosDate and ChronosTime do not. Several parameters were expanded to allow DateTimeInterface instead of requiring only Chronos objects.

After making the original changes in 3.0.0, we realized that the supported PHP versions (8.1+) do not have the original bugs that made extending DateTimeImmutable either problematic or impossible in the future.

ChronosDate is intended to be a separate object and will not extend DateTimeImmutable as it supports mutating time and time zones which is hard to support.

ChronosTime was never meant to extend DateTimeImmutable and is part of the reason why ChronosInterface was removed as it doesn't represent a true shared interface.

An explanation of the reason behind the 3.0 changes can be found here: https://github.com/cakephp/chronos/issues/410#issuecomment-1722185717

What's Changed

• Change only Chronos to extend DateTimeImmutable once again by @othercorey in https://github.com/cakephp/chronos/pull/417
• Support creating Chronos from ChronosTime by @othercorey in https://github.com/cakephp/chronos/pull/425
• Allow passing DatePeriod options to diffFiltered() by @othercorey in https://github.com/cakephp/chronos/pull/429
• Allow setting time zone when converting to DateTimeImmutable by @othercorey in https://github.com/cakephp/chronos/pull/430
• Add halfOfYear, isFirstHalfOfYear, IsSecondHalfOfYear; improve getter… by @brenoroosevelt in https://github.com/cakephp/chronos/pull/421
• Add third Parameter $others to farthest and closest Methods by @brenoroosevelt in https://github.com/cakephp/chronos/pull/422=
• Align Chronos::getTimezone() return type with DateTimeImmutable by @othercorey in https://github.com/cakephp/chronos/pull/423
• Add toDateTimeImmutable() by @othercorey in https://github.com/cakephp/chronos/pull/424 and https://github.com/cakephp/chronos/pull/427
• Fix casting to string for ChronosDate and ChronosTime. by @ADmad in https://github.com/cakephp/chronos/pull/428
• Remove ChronosInterface references and clean up ChronosDate and ChronosTime refs by @othercorey in https://github.com/cakephp/chronos/pull/431

New Contributors

• @brenoroosevelt made their first contribution in https://github.com/cakephp/chronos/pull/421

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.1...3.0.2

What's Changed

• Add missing default for ChronosInterface::now() by @othercorey in https://github.com/cakephp/chronos/pull/412

Full Changelog: https://github.com/cakephp/chronos/compare/2.4.0...2.4.1

What's Changed

• Re-introduce Chronos::getLastErrors() by @othercorey in https://github.com/cakephp/chronos/pull/409

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.0...3.0.1

Major Changes

• Date was renamed to ChronosDate and will be dropped in 3.0
• MutableDate and MutableDateTime were deprecated and will be removed in 3.0
• Deprecated several methods no longer supported in 3.0 - see https://book.cakephp.org/chronos/2/en/2-4-upgrade-guide.html

What's Changed

• Start deprecations for 2.next by @markstory in https://github.com/cakephp/chronos/pull/344
• 2.next - Rename Date to ChronosDate. Deprecate MutableDate and MutableDateTime. by @othercorey in https://github.com/cakephp/chronos/pull/348
• Change all use of Date to ChronosDate by @othercorey in https://github.com/cakephp/chronos/pull/350
• 2.next Backport createInterval() by @markstory in https://github.com/cakephp/chronos/pull/349
• 2.5 - Backport date by @markstory in https://github.com/cakephp/chronos/pull/363
• 2.5 - More deprecations by @markstory in https://github.com/cakephp/chronos/pull/367
• 2.5 Remaining deprecations by @markstory in https://github.com/cakephp/chronos/pull/371
• Make setTimezone deprecation conditional by @markstory in https://github.com/cakephp/chronos/pull/372
• First draft of 2.4 upgrade guide by @markstory in https://github.com/cakephp/chronos/pull/375
• 2.4 - Add deprecations for createFromTimestampUTC() by @markstory in https://github.com/cakephp/chronos/pull/379
• 2.next: fix setISODate by @LordSimal in https://github.com/cakephp/chronos/pull/392
• 2.next: remove deprecation for setISODate by @LordSimal in https://github.com/cakephp/chronos/pull/394
• 2.x: adjust CI to not ignore-platform-reqs by @LordSimal in https://github.com/cakephp/chronos/pull/399

Full Changelog: https://github.com/cakephp/chronos/compare/2.3.3...2.4.0

Chronos 3 introduces some large changes driven by changes in PHP 8 (and expected change in PHP 9).

The biggest change is Chronos and ChronosDate no longer extend DateTimeImmutable which means they no longer implement DateTimeInterface. This will affect projects that use either of these as type declarations and pass in Chronos objects.

All of the relevant methods from DateTimeImmutable are still available on Chronos and ChronosDate. Some methods that were only relevant for Chronos were dropped from ChronosDate and so on.

If you need to pass a DateTimeImmutable or DateTimeInterface objects to a library, you can use the toNative() helper to get the equivalent DateTimeImmutable object.

Major Changes

• Chronos and ChronosDate no longer extend DateTimeImmutable and no longer implement DateTimeInterface
• ChronosInterface was dropped as Chronos and ChronosDate no longer extend the same base and don't try to share incompatible methods.
• MutableDateTime and MutableData were dropped
• ChronosTime was added which supports parsing strings and conversion from Chronos and DateTimeInterface

What's Changed

• Default ChronosTime to server time by @othercorey in https://github.com/cakephp/chronos/pull/386
• Add ComparisonTrait::isSameMonth()/ComparisonTrait::isSameYear() by @andrii-pukhalevych in https://github.com/cakephp/chronos/pull/384
• Add timezone to ChronosTime::now() by @othercorey in https://github.com/cakephp/chronos/pull/389
• Add comparison helpers to ChronosTime by @othercorey in https://github.com/cakephp/chronos/pull/390
• 3.x: re-add setISODate by @LordSimal in https://github.com/cakephp/chronos/pull/395

New Contributors

• @andrii-pukhalevych made their first contribution in https://github.com/cakephp/chronos/pull/384

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.0-beta2...3.0.0-beta3

What's Changed

• Update docs for Date + timezone by @markstory in https://github.com/cakephp/chronos/pull/388
• Return the false returned by parent::getLastErrors() as default errors array by @zonuexe in https://github.com/cakephp/chronos/pull/391

New Contributors

• @zonuexe made their first contribution in https://github.com/cakephp/chronos/pull/391

Full Changelog: https://github.com/cakephp/chronos/compare/2.3.2...2.3.3

What's Changed

• Remove carbon migration notes by @othercorey in https://github.com/cakephp/chronos/pull/369
• Fix up PHPStan by @dereuromark in https://github.com/cakephp/chronos/pull/374
• Fix up getTimezone() by @dereuromark in https://github.com/cakephp/chronos/pull/373
• 3.x: new stan setup by @LordSimal in https://github.com/cakephp/chronos/pull/376
• PHPStan fixes, set level to 8 now by @dereuromark in https://github.com/cakephp/chronos/pull/378
• Remove not needed legacy API method. by @dereuromark in https://github.com/cakephp/chronos/pull/342
• Add toNative() helpers by @othercorey in https://github.com/cakephp/chronos/pull/381
• Add ChronosTime by @othercorey in https://github.com/cakephp/chronos/pull/380

New Contributors

• @LordSimal made their first contribution in https://github.com/cakephp/chronos/pull/376

Full Changelog: https://github.com/cakephp/chronos/compare/3.0.0-beta1...3.0.0-beta2

Chronos 2.4.0 will be backwards compatible with the rest of Chronos 2.x. However, 2.4.0 will introduce deprecations to the mutable classes and many methods in preparation for the changes coming in Chronos 3. The upgrade guide has more information on the upcoming changes and how to update your application.

Chronos 2.4.0 will be backwards compatible with the rest of Chronos 2.x. However, 2.4.0 will introduce deprecations to the mutable classes and many methods in preparation for the changes coming in Chronos 3. The upgrade guide has more information on the upcoming changes and how to update your application.

Chronos 3.0 will be a major release that contains breaking changes. This beta release provides a preview release of what will be coming in the future and unblocks CakePHP 5.0 beta releases.

Summary of Breaking changes

• Removed Mutable datetime and date classes.
• ChronosDate no longer implements DateTimeInterface and doesn't share types with Chronos either. This resolves a long standing interface compatibility issue where Date and DateTime objects appeared to be more type compatible than they should be.
• Chronos no longer implements DateTimeInterface or extends DateTimeImmutable. Instead Chronos is a wrapper around PHP's datetime, and continues to offer a similar interface to the PHP objects.
• Removed Carbon compatibility shims. While chronos started out as a fork of Carbon due to lack of maintainship, the Carbon project has new maintainers and we no longer need to encroach on that namespace.

Upgrading

In the future 2.4 will be released with deprecations to help with upgrading to chronos 3.x

What's Changed

• Fix: Unexpected Human Interval Values by @MGatner in https://github.com/cakephp/chronos/pull/323
• Switch human diff to months when interval is 2+ months by @othercorey in https://github.com/cakephp/chronos/pull/343

Full Changelog: https://github.com/cakephp/chronos/compare/2.3.1...2.3.2

What's Changed

• Fix passing negative value to sub helpers such as subYears(-1) for PHP 8.2

Changes

• Added missing microsecond() setter.