💥 Breaking changes

• Minimum PHP version is now 8.2
• The following classes are now final:
  • YearMonthRange
  • ZonedDateTime
  • Parser\DateTimeParseException

✨ Compatibility improvements

• The following parser and parse methods now accept hours only in timezone offsets, such as +01 equivalent to +01:00 (#123 by @antonkomarev):
  • IsoParsers:timeZoneOffset()
  • TimeZoneOffset::parse()
  • ZonedDateTime::parse()

Contributors

• @antonkomarev

💥 Breaking changes

• Duration::toISOString() and __toString() now output negative durations as -P... (#122 by @BastienClement)
  Example: -PT2H21M instead of PT-2H-21M.
  This aligns with ISO 8601-2:2019 and improves compatibility with the JavaScript Temporal API.

Contributors

• @BastienClement

🐛 Bug fixes

• ZoneDateTime incorrectly handled DST Transitions with relative time addition (#115)

✨ New features

• LocalDate::getQuarter() and getQuarterValue() return the quarter of the year (#114 by @pscheit)

Contributors

• @pscheit

💥 Breaking changes

• DayOfWeek:
  • deprecated method of() has been removed, use DayOfWeek::from() instead
  • the following deprecated methods have been removed, use enum values instead:
    • DayOfWeek::monday() → DayOfWeek::MONDAY
    • DayOfWeek::tuesday() → DayOfWeek::TUESDAY
    • DayOfWeek::wednesday() → DayOfWeek::WEDNESDAY
    • DayOfWeek::thursday() → DayOfWeek::THURSDAY
    • DayOfWeek::friday() → DayOfWeek::FRIDAY
    • DayOfWeek::saturday() → DayOfWeek::SATURDAY
    • DayOfWeek::sunday() → DayOfWeek::SUNDAY
  • deprecated method getValue() has been removed, use $dayOfWeek->value instead
  • deprecated method is() has been removed, compare values with $dayOfWeek or $dayOfWeek->value instead
  • deprecated method isEqualTo() has been removed, use strict equality === between DayOfWeek instances instead.
• DefaultClock:
  • deprecated method travel() has been removed, use travelTo() instead
• LocalDate:
  • deprecated method getDay() has been removed, use getDayOfMonth() instead
  • getMonth() now returns a Month enum; use getMonthValue() if you want the month number
• LocalDateTime:
  • deprecated method getDay() has been removed, use getDayOfMonth() instead
  • getMonth() now returns a Month enum; use getMonthValue() if you want the month number
• Month:
  • deprecated method of() has been removed, use Month::from() instead
  • deprecated method getAll() has been removed, use Month::cases() instead
  • deprecated method getValue() has been removed, use $month->value instead
  • deprecated method is() has been removed, compare values with $month or $month->value instead
  • deprecated method isEqualTo() has been removed, use strict equality === between Month instances instead
• MonthDay:
  • deprecated method getDay() has been removed, use getDayOfMonth() instead
  • getMonth() now returns a Month enum; use getMonthValue() if you want the month number
• YearMonth:
  • getMonth() now returns a Month enum; use getMonthValue() if you want the month number
• ZonedDateTime:
  • deprecated method getDay() has been removed, use getDayOfMonth() instead
  • getMonth() now returns a Month enum; use getMonthValue() if you want the month number

🔧 Improvements

• Methods returning int are now type-annotated with int ranges

✨ New methods

• LocalDate::previousDayOfWeek()
• LocalDate::previousOrSameDayOfWeek()
• LocalDate::nextDayOfWeek()
• LocalDate::nextOrSameDayOfWeek()

✨ New features

• DefaultClock::travelBy() travels in time by a duration (#92)

🗑️ Deprecations

• DefaultClock::travel() is now deprecated in favour of travelTo() (#92)

Thanks to @francislavoie!

Contributors

• @francislavoie

✨ New features

• Stopwatch::stop() now returns the lap duration (#98)

Thanks to @rodnaph!

Contributors

• @rodnaph

✨ New features

• MonthDay::of() and MonthDay::withMonth() now accept a Month enum as parameter (#106)
• LocalDate::of() and LocalDate::withMonth() now accept a Month enum as parameter (#106)
• LocalDateTime::of() and LocalDateTime::withMonth() now accept a Month enum as parameter (#106)
• ZonedDateTime::withMonth() now accepts a Month enum as parameter (#106)

✨ Undeprecations

• Passing an int to Year::atMonth() is un-deprecated, and now valid again (#103)
• Passing an int to YearMonth::of() and YearMonth::withMonth() is un-deprecated, and now valid again (#103)
• Passing an int to YearWeek::atDay() is un-deprecated, and now valid again (#103)

Thanks to @gnutix!

Contributors

• @gnutix

✨ New features

• Year::atMonth() now accepts a Month enum as parameter (#95)
• YearMonth::of() and YearMonth::withMonth() now accept a Month enum as parameter (#96)

🔧 Improvements

• Narrower Psalm types for compareTo(), __toString(), toISOString(), jsonSerialize() methods (#97)

💩 Deprecations

• Passing an int to Year::atMonth() is now deprecated, pass a Month enum instead (#95)
• Passing an int to YearMonth::of() and YearMonth::withMonth() is now deprecated, pass a Month enum instead (#96)

Thanks to @gnutix!

Contributors

• @gnutix