Skip to content

Changelog

Version 3.x

3.14.0 (12 September 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.13.3...3.14.0

⚠️ If you unserialize CarbonPeriod objects that may have custom filters or custom dateClass, you might experience breaking change in some specific edge cases starting with this version

3.13.3 (6 September 2026)

New Contributors

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.13.2...3.13.3

3.13.2 (8 August 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.13.1...3.13.2

3.13.1 (9 July 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.13.0...3.13.1

3.13.0 (18 June 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.12.3...3.13.0

3.12.3 (14 June 2026)

  • Improve plus() and minus() method by @kylekatarnls in https://github.com/CarbonPHP/carbon/pull/126
    • Add $anchorDay parameter and OverflowMode for $overflow parameter
    • Add float support for $weeks, $days, $hours, $minutes, $seconds and $microseconds
    • Use __call so sub-classes are allowed to override those methods with divergent signatures

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.12.2...3.12.3

3.12.2 (14 June 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.12.1...3.12.2

3.12.1 (14 June 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.12.0...3.12.1

3.12.0 (14 June 2026)

New Contributors

Full Changelog: https://github.com/briannesbitt/Carbon/compare/3.11.4...3.12.0

3.11.4 (7 April 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.11.3...3.11.4

3.11.3 (11 March 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.11.2...3.11.3

3.11.2 (10 March 2026)

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.11.1...3.11.2

3.11.1 (29 January 2026)

New Contributors

Full Changelog: https://github.com/CarbonPHP/carbon/compare/3.11.0...3.11.1

3.11.0 (2 December 2025)

Complete commits list

New contributors:

3.10.3 (6 September 2025)

Complete commits list

New contributors:

3.10.2 (2 August 2025)

Complete commits list

New contributors:

3.10.1 (21 June 2025)

Complete commits list

3.10.0 (12 June 2025)

Complete commits list

New contributors:

3.9.1 (1 May 2025)

Complete commits list

New contributors:

3.9.0 (27 March 2025)

Complete commits list

New contributors:

3.8.6 (20 February 2025)

Complete commits list

3.8.5 (11 February 2025)

Complete commits list

New contributors:

3.8.4 (27 December 2024)

  • Validate locale earlier

Complete commits list

3.8.3 (21 December 2024)

Complete commits list

New contributors:

3.8.2 (7 November 2024)

Complete commits list

3.8.1 (3 November 2024)

Complete commits list

3.8.0 (19 August 2024)

Complete commits list

New contributors:

3.7.0 (16 July 2024)

Complete commits list

New contributors:

3.6.0 (20 June 2024)

  • Add support for Month and WeekDay enums in is() method @kylekatarnls #3036
  • Build period with given timezone @kylekatarnls #3041
  • Unserialize carbon interval created by v2 @kylekatarnls #3042

Complete commits list

3.5.0 (3 June 2024)

  • Fix New Zealand daylight saving time format to pass hasFormat v3 @Luoti #3031
  • Split CarbonPeriod construction into multiple steps @kylekatarnls #3024
  • Make CarbonPeriod compatible with PHP 8.4 @kylekatarnls #3023
  • Fix diffInDays DST bug @kylekatarnls #3026
  • Fix issue with is month check @kylekatarnls #3033

Complete commits list

New contributors:

  • @Luoti made their first contribution in #3031

3.4.0 (24 May 2024)

  • Unserialize CarbonInterval from v2 @kylekatarnls #3016
  • Remove overridden EXCLUDE_START_DATE constant @iluuu1994 #3022

Complete commits list

New contributors:

  • @iluuu1994 made their first contribution in #3022

3.3.1 (1 May 2024)

  • Fix days for diffForHumans for slovak @edvordo #3007
  • Support %a format #3013
  • Fix translator and interval serialization #3005
  • Fallback to default timezone for mocked now #3014

Complete commits list

New contributors:

  • @edvordo made their first contribution in #3007

3.3.0 (18 April 2024)

  • Create a dedicated method for each step of the magic __call process #2992
  • Update Bosnian translations #2994
  • Handle null in canBeCreatedFromFormat #2997
  • Allow carbon instance to be rounded by a CarbonInterval, which is not in default language @kohlerdominik #2999
  • Update Slovak translations @pkundis #2995
  • Add locale and translator options to forHumans and diffForHumans #3001

Complete commits list

New contributors:

  • @kohlerdominik made their first contribution in #2999
  • @pkundis made their first contribution in #2995

3.2.4 (5 April 2024)

  • Re-allow macro with names starting with diff #2991

Complete commits list

3.2.3 (30 March 2024)

  • Update Docs for diffIn methods that return float @Nathanjms #2988
  • Fix deprecation notice for diffInReal* (prefer diffInUTC*, or for any unit smaller than day, simply diffIn*)

Complete commits list

3.2.2 (28 March 2024)

  • Fallback to default parameters if period construction fails #2987

Complete commits list

3.2.1 (27 March 2024)

  • Make start and end period properties correct at creation #2984

Complete commits list

3.2.0 (27 March 2024)

  • Fix PHP 8.4 implicit nullability deprecation @Ayesh #2969
  • Use current timezone if identical to compared value for diff #2972
  • Correction of Months' Names In CKB language #2973
  • Stop using start/end on interval if they are changed after creation #2981
  • Deprecate Real diff in favor of UTC diff #2975
  • Allow integer in createFromFormat() #2983

Complete commits list

New contributors:

  • @kawan97 made their first contribution in #2973

3.1.1 (13 March 2024)

  • Fixed Persian translation for before and after #2963
  • Cleaned up region list and add warranty notice on methods relying on it #2964
  • Fixed incomplete type for create method PHPDoc #2962

Complete commits list

New contributors:

  • @shane-zeng made their first contribution in #2962

3.1.0 (6 March 2024)

  • Fixed Persian translation for before and after #2941
  • Allowed to pass Unit enum for unit name #2944
  • Updated PHPDoc #2946
  • Removed suffix to Taiwan name #2957

Complete commits list

New contributors:

  • @azim-kordpour made their first contribution in #2941

3.0.2 (6 February 2024)

  • Fixed PHP 8.1 issue "Enum case value must be compile-time evaluatable": Use static values for enums until dropping PHP 8.1 #2938

Complete commits list

3.0.1 (5 February 2024)

  • Allowed to remove macro by passing null value #2935 #2936 #2937

Complete commits list

3.0.0 (31 January 2024)

  • Dropped PHP < 8.1 #2810 #2385 #2346
  • Dropped Symfony < 4.4 #2070
  • Added enums for week days, months and units #2701
  • Added generic unitOfUnit and unitsInUnit getters #2885
  • ⚠ Changed diffIn* methods to return float and relative diff ($absolute = false by default) #2119
    • diffIn* will use the floatDiffInReal* behavior, all other variants will be removed
  • Changed CarbonPeriod to extend DatePeriod #1752
  • Changed create* method to return null instead of false #2340
  • Changed forHumans() to show 0 seconds y default for empty intervals #2035
  • Changed CarbonInterval to be empty by default #2079
  • Changed week methods to work with current global locale #1967
  • Allowed to add and subtract decimal numbers of any unit #2347 #2519
  • Changed factories to have isolated settings, locale, testNow, macros and default timezone #2345
  • Changed $tz with $timezone for named argument #2925
  • Changed parse() return type to non-nullable static #2931 — @jnoordsij
  • Fixed short year Ukrainian plural #2923
  • Fixed resolve* method return type so to allow sub-classes to take other sub-classes as parameters
  • Fixed fallback from setter to macro #2922

Complete commits list

3.0.0-rc.3 (31 January 2024)

Complete commits list

3.0.0-rc.1 (26 January 2024)

Complete commits list

3.0.0-beta.3 (24 January 2024)

  • Fixed fallback from setter to macro #2922

Complete commits list

3.0.0-beta.2 (23 January 2024)

  • Fixed resolve* method return type so to allow sub-classes to take other sub-classes as parameters

Complete commits list

3.0.0-beta.1 (22 January 2024)

  • Dropped PHP < 8.1 #2810 #2385 #2346
  • Dropped Symfony < 4.4 #2070
  • Added enums for week days, months and units #2701

Complete commits list

Version 2.x

Info

Only release dates are listed here.

  • 2.73.0 (8 January 2025)
  • 2.72.6 (27 December 2024)
  • 2.72.5 (3 June 2024)
  • 2.72.4 (3 June 2024)
  • 2.72.3 (25 January 2024)
  • 2.72.2 (19 January 2024)
  • 2.72.1 (8 December 2023)
  • 2.72.0 (28 November 2023)
  • 2.71.0 (25 September 2023)
  • 2.70.0 (7 September 2023)
  • 2.69.0 (3 August 2023)
  • 2.68.1 (20 June 2023)
  • 2.68.0 (15 June 2023)
  • 2.67.0 (25 May 2023)
  • 2.66.0 (29 January 2023)
  • 2.65.0 (6 January 2023)
  • 2.64.1 (1 January 2023)
  • 2.64.0 (26 November 2022)
  • 2.63.0 (30 October 2022)
  • 2.62.1 (2 September 2022)
  • 2.62.0 (28 August 2022)
  • 2.61.0 (6 August 2022)
  • 2.60.0 (27 July 2022)
  • 2.59.1 (29 June 2022)
  • 2.59.0 (26 June 2022)
  • 2.58.0 (25 April 2022)
  • 2.57.0 (13 February 2022)
  • 2.56.0 (21 January 2022)
  • 2.55.2 (3 December 2021)
  • 2.55.1 (3 December 2021)
  • 2.55.0 (2 December 2021)
  • 2.54.0 (1 November 2021)
  • 2.53.1 (6 September 2021)
  • 2.53.0 (6 September 2021)
  • 2.52.0 (14 August 2021)
  • 2.51.1 (28 July 2021)
  • 2.51.0 (28 July 2021)
  • 2.50.0 (28 June 2021)
  • 2.49.0 (2 June 2021)
  • 2.48.1 (26 May 2021)
  • 2.48.0 (7 May 2021)
  • 2.47.1 (26 May 2021)
  • 2.47.0 (13 April 2021)
  • 2.46.0 (24 February 2021)
  • 2.45.1 (11 February 2021)
  • 2.45.0 (7 February 2021)
  • 2.44.0 (26 January 2021)
  • 2.43.0 (17 December 2020)
  • 2.42.0 (28 November 2020)
  • 2.41.5 (23 October 2020)
  • 2.41.4 (22 October 2020)
  • 2.41.3 (12 October 2020)
  • 2.41.2 (10 October 2020)
  • 2.41.1 (10 October 2020)
  • 2.41.0 (4 October 2020)
  • 2.40.1 (23 September 2020)
  • 2.40.0 (11 September 2020)
  • 2.39.2 (10 September 2020)
  • 2.39.1 (4 September 2020)
  • 2.39.0 (24 August 2020)
  • 2.38.0 (4 August 2020)
  • 2.37.0 (28 July 2020)
  • 2.36.1 (4 July 2020)
  • 2.36.0 (25 June 2020)
  • 2.35.0 (24 May 2020)
  • 2.34.2 (19 May 2020)
  • 2.34.1 (19 May 2020)
  • 2.34.0 (12 May 2020)
  • 2.33.0 (20 April 2020)
  • 2.32.2 (31 March 2020)
  • 2.32.1 (26 March 2020)
  • 2.32.0 (24 March 2020)
  • 2.31.0 (1 March 2020)
  • 2.30.0 (7 February 2020)
  • 2.29.1 (21 January 2020)
  • 2.29.0 (21 January 2020)
  • 2.28.0 (16 December 2019)
  • 2.28.0-beta.1 (12 December 2019)
  • 2.27.0 (20 November 2019)
  • 2.26.0 (21 October 2019)
  • 2.25.3 (20 October 2019)
  • 2.25.2 (14 October 2019)
  • 2.25.1 (5 October 2019)
  • 2.25.0 (30 September 2019)
  • 2.25.0-beta.3 (30 September 2019)
  • 2.25.0-beta.2 (13 September 2019)
  • 2.25.0-beta.1 (9 September 2019)
  • 2.24.0 (31 August 2019)
  • 2.24.0-beta.4 (31 August 2019)
  • 2.24.0-beta.3 (28 August 2019)
  • 2.24.0-beta.2 (27 August 2019)
  • 2.24.0-beta.1 (23 August 2019)
  • 2.23.1 (17 August 2019)
  • 2.23.0 (12 August 2019)
  • 2.23.0-beta.4 (12 August 2019)
  • 2.23.0-beta.3 (7 August 2019)
  • 2.23.0-beta.2 (4 August 2019)
  • 2.23.0-beta.1 (3 August 2019)
  • 2.22.3 (7 August 2019)
  • 2.22.1 (6 August 2019)
  • 2.22.0 (28 July 2019)
  • 2.22.0-beta.3 (28 July 2019)
  • 2.22.0-beta.2 (25 July 2019)
  • 2.22.0-beta.1 (19 July 2019)
  • 2.21.3 (18 July 2019)
  • 2.21.2 (17 July 2019)
  • 2.21.0 (14 July 2019)
  • 2.20.0 (25 June 2019)
  • 2.19.2 (7 June 2019)
  • 2.19.1 (4 June 2019)
  • 2.19.0 (30 May 2019)
  • 2.18.0 (16 May 2019)
  • 2.17.1 (27 April 2019)
  • 2.17.0 (17 April 2019)
  • 2.16.3 (6 April 2019)
  • 2.16.2 (29 March 2019)
  • 2.16.1 (20 March 2019)
  • 2.16.0 (12 March 2019)
  • 2.15.0 (7 March 2019)
  • 2.14.2 (28 February 2019)
  • 2.14.1 (27 February 2019)
  • 2.14.0 (25 February 2019)
  • 2.13.0 (20 February 2019)
  • 2.12.0 (6 February 2019)
  • 2.11.0 (29 January 2019)
  • 2.10.1 (14 January 2019)
  • 2.10.0 (2 January 2019)
  • 2.9.1 (25 December 2018)
  • 2.9.0 (25 December 2018)
  • 2.8.0 (18 December 2018)
  • 2.7.0 (2 December 2018)
  • 2.6.1 (22 November 2018)
  • 2.6.0 (19 November 2018)
  • 2.5.4 (15 November 2018)
  • 2.5.3 (13 November 2018)
  • 2.5.2 (12 November 2018)
  • 2.5.1 (8 November 2018)
  • 2.5.0 (26 October 2018)
  • 2.4.1 (17 October 2018)
  • 2.4.0 (16 October 2018)
  • 2.3.1 (17 October 2018)
  • 2.3.0 (27 September 2018)
  • 2.2.1 (17 October 2018)
  • 2.2.0 (20 September 2018)
  • 2.1.1 (17 October 2018)
  • 2.1.0 (3 September 2018)
  • 2.0.1 (17 October 2018)
  • 2.0.0 (23 August 2018)
  • 2.0.0-beta.6 (23 August 2018)
  • 2.0.0-beta.5 (23 August 2018)
  • 2.0.0-beta.4 (23 August 2018)
  • 2.0.0-beta.3 (20 August 2018)
  • 2.0.0-beta.2 (13 August 2018)
  • 2.0.0-beta.1 (8 August 2018)

Version 1.x

Info

Only release dates are listed here.

  • 1.39.1 (14 October 2019)
  • 1.39.0 (11 June 2019)
  • 1.38.4 (3 June 2019)
  • 1.38.2 (30 May 2019)
  • 1.38.1 (30 May 2019)
  • 1.38.0 (30 May 2019)
  • 1.37.1 (19 April 2019)
  • 1.36.2 (28 December 2018)
  • 1.36.1 (22 November 2018)
  • 1.36.0 (16 November 2018)
  • 1.35.1 (14 November 2018)
  • 1.35.0 (14 November 2018)
  • 1.34.4 (13 November 2018)
  • 1.34.3 (13 November 2018)
  • 1.34.2 (12 November 2018)
  • 1.34.1 (8 November 2018)
  • 1.34.0 (20 September 2018)
  • 1.33.0 (7 August 2018)
  • 1.32.0 (5 July 2018)
  • 1.31.1 (25 June 2018)
  • 1.31.0 (24 June 2018)
  • 1.30.0 (15 June 2018)
  • 1.29.2 (29 May 2018)
  • 1.29.1 (24 May 2018)
  • 1.29.0 (24 May 2018)
  • 1.28.0 (18 May 2018)
  • 1.27.0 (23 April 2018)
  • 1.26.6 (3 June 2019)
  • 1.26.5 (30 May 2019)
  • 1.26.4 (17 April 2018)
  • 1.26.3 (16 April 2018)
  • 1.26.2 (16 April 2018)
  • 1.26.1 (16 April 2018)
  • 1.26.0 (16 April 2018)
  • 1.25.3 (3 June 2019)
  • 1.25.1 (31 May 2019)
  • 1.25.0 (19 March 2018)
  • 1.24.2 (10 March 2018)
  • 1.24.1 (9 March 2018)
  • 1.24.0 (9 March 2018)
  • 1.23.0 (28 February 2018)
  • 1.22.1 (16 January 2017)
  • 1.22.0 (15 January 2017)
  • 1.21.0 (4 November 2015)
  • 1.20.0 (25 June 2015)
  • 1.19.0 (9 May 2015)
  • 1.18.0 (26 March 2015)
  • 1.17.0 (8 March 2015)
  • 1.16.0 (4 March 2015)
  • 1.15.0 (3 March 2015)
  • 1.14.0 (6 February 2015)
  • 1.13.0 (26 September 2014)
  • 1.12.0 (10 September 2014)
  • 1.11.0 (26 August 2014)
  • 1.10.0 (18 July 2014)
  • 1.9.0 (13 May 2014)
  • 1.8.0 (7 January 2014)
  • 1.7.0 (5 December 2013)
  • 1.6.0 (23 November 2013)
  • 1.5.0 (21 November 2013)
  • 1.4.0 (9 September 2013)
  • 1.3.0 (21 August 2013)
  • 1.2.0 (15 October 2012)
  • 1.1.0 (17 September 2012)
  • 1.0.1 (11 September 2012)
  • 1.0.0 (11 September 2012)