NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #774 most downloaded on PyPI
Open World Holidays Framework
Last release 2 days ago
29 Sep 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
174 releases · first in 2014
Add subdivision category holidays support (#1446 by @KJhellico)
Released September 4, 2023
Full Changelog: https://github.com/vacanza/python-holidays/compare/v.0.31...v.0.32
Refactor HolidayBase methods (#1425 by @KJhellico)
Released August 21, 2023
New Contributors:
Full Changelog: https://github.com/vacanza/python-holidays/compare/v.0.30...v.0.31
One column per quarter.
Introduce substituted holidays [PoC] (#1365 by @KJhellico)
Released August 7, 2023
HolidayBase::_add_holiday family methods [PoC] (#1368 by @arkid15r)Full Changelog: https://github.com/vacanza/python-holidays/compare/v.0.29...v.0.30
Refactor movable holidays (#1357 by @KJhellico)
Released July 17, 2023
Full Changelog: https://github.com/dr-prodigy/python-holidays/compare/v.0.28...v.0.29
Add special holidays categories support (#1347 by @KJhellico)
Released July 3, 2023
holiday_groups, add l10n support (#1338 by @PPsyrius, @arkid15r)holiday_groups (#1342 by @PPsyrius)#noqa E501 labels (#1322 by @PPsyrius)Fix HolidayBase::pop_named partial holiday names removal (#1325 by @arkid15r)
Released June 21, 2023
Full Changelog: https://github.com/dr-prodigy/python-holidays/compare/v.0.27...v.0.27.1
Refactor HolidayBase::pop_named (#1306 by @arkid15r)
Released June 19, 2023
_add_childrens_day(...) to InternationalHolidays (#1300 by @PPsyrius)Full Changelog: https://github.com/dr-prodigy/python-holidays/compare/v.0.26...v.0.27
Add estimated_label localization support to Asian holiday groups (#1229 by @KJhellico)
Released June 5, 2023
Introduce entity lazy loading, #1087 (@arkid15r)
Released May 15, 2023
th tests and translation, #1147 (@PPsyrius)Full Changelog: https://github.com/dr-prodigy/python-holidays/compare/v.0.24...v.0.25
Introduce Islamic holidays pre-calculated data, #1090 (@KJhellico)
Released May 1, 2023
Full Changelog: https://github.com/dr-prodigy/python-holidays/compare/v.0.23...v.0.24
Add Islamic multi-day holidays support to holiday_groups, #1086 (@KJhellico)
Released April 17, 2023
Introduce holiday groups, #865 (@arkid15r, @KJhellico)
Released April 3, 2023
get_named() lookup types: add [i]startswith, #1062 (@arkid15r)Refactor NYSE holidays, #1018 (@KJhellico)
Released March 15, 2023
Refactor HolidayBase::get_named, #991 (@arkid15r)
Released March 6, 2023
HolidayBase::get_named, #991 (@arkid15r)Add localization support, #827 (@arkid15r, @bkthomps, @dragoon)
Released February 23, 2023
HolidayBase::_is_leap_year(), #886 (@arkid15r)HolidayBase::_is_monday - HolidayBase::_is_sunday helper methods, #841 (@arkid15r)relativedelta with timedelta (tests), #901 (@arkid15r)relativedelta with timedelta, #900 (@arkid15r)Added Arkadii Yakovets (@arkid15r) to project collaborators / maintainers - welcome!
Released January 30, 2023
Code refactoring #801, #870 (arkid15r)
Released December 27, 2022
Flake8 pre-commit source change to github.com (dr-p)
Released November 23, 2022
Released November 23, 2022 - Swaziland deprecation warning fix #794 (arkid15r)
First release (0.17) November 13, 2022
Swaziland deprecation, replaced by Eswatini #721 (bkthomps)
Released November 13, 2022
This release is dedicated to Queen Elizabeth II (21 April 1926 – 8 September 2022), who lived her long life as a monarch through 2 centuries, in both
Released September 16, 2022
This release is dedicated to Queen Elizabeth II (21 April 1926 – 8 September 2022), who lived her long life as a monarch through 2 centuries, in both happy and difficult moments, with grace, dignity and an always inspiring strong sense of duty and warm heart. Goodbye "Lilibet", you have symbolically been a queen, a mother and a grandmother to a lot of us, and will be dearly missed.
Added support for Python3.11 (dr-p)
Released August 21, 2022
Drop support for EOL Python 3.6 #328 (hugovk, dr-p)
Released June 5, 2022
New subdivision parameter (subdiv), prov/state deprecation #608, #597, #374 (mborsetti)
Released February 15, 2022
UK standalone states deprecation #566 (dr-p)
Released January 4, 2022
Release increase (v.0.12, was v.0.11.4 during beta)
Copyright update 2022
Sphinx documentation (mborsetti, dr-p)
Support for Kazakhstan #534 (chiuczek, intelliHugh)
Support for Azerbaijan #540 (eldar-mustafayev)
Support for Tunisia #543 (ihebski)
Support for Taiwan #547 (ifurther)
Support for North Macedonia #570 (tserekh)
Support for Ethiopia #558 (tedtad, dr-p)
Travis CI removal #557 (mborsetti, dr-p)
CD/CI tests - Pypi versions review (dr-p)
More useful repr and str #360 (dr-p, kootenpv, d33tah)
Drop support for Czech (ie: misspelled Czechia) (dr-p)
Drop support for Polish (ie: misspelled Poland) (dr-p)
Drop support for Slovak (ie: misspelled Slovakia) (dr-p)
Test coverage improvement (dr-p)
"country" property moved to class attributes #573 (dr-p, madphysicist)
Date slices support fix #529, #530 (justinwaf, mborsetti, dr-p)
Doc fixes #549 (canute24)
UK standalone states deprecation #566 (dr-p)
Venezuela ISO code + other fixes #567, #576 (Skatox, dr-p, antusystem)
Canada updates and test review #533, #536 (cturra)
US updates and fixes #537, #559, #578 (khawley, evohnave, amelkiy, dr-p)
India fixes #553, #554, #539 (canute24, dr-p)
Spain fixes #555 (tserekh)
Italy fixes #546 (dr-p, rtraverso86)
Korea fixes #535 (0xF4D3C0D3)
Colombia fixes #564 (jahirfiquitiva)
Support for Zambia #495, #496 (engineervix)
Released September 29, 2021
Support for Venezuela #470 (antusystem, dr-p)
Released July 18, 2021
Released July 18, 2021
Github Actions CI/CD integration (s-weigand, dr-p)
Released April 2, 2021
Dropped support for Python 2 (dr-p)
Released February 4, 2021
Support for Djibouti (Abdisamade)
Released December 6, 2020
Added get_named(substring) method to retrieve holidays by name (dr-p)
Released July 15, 2020
Support for Spain (piliamaurizio, jbroudou, dr-p, gerardo15)
Released April 13, 2020
Project structure refactoring (MaxHaertwig, dr-p)
Released January 25, 2020
Support for India - Telangana (kiranbeethoju, dr-p)
Released December 23, 2019
Polish deprecation: replaced by Poland (dr-p)
Released July 28, 2019
Added Lithuanian holidays support (GiedriusMauza)
Released March 12, 2019
Magic numbers removal (elln2, dr-p)
Released January 3, 2019
Released October 18, 2018 - Added Ukraine (Anian-igor) - Added Croatia (fran1987) - Added Brazil (fcrespo82)
Released October 18, 2018
Added prov/state parameters to CountryHoliday() (luto)
Released September 12, 2018
Fixed Canadian holidays (Canada / Dominion Day)
Released August 1, 2018
Added Argentina (Emmanuel Arias)
Released April 23, 2018
Czech deprecation: replaced by Czechia (janpipek)
Released March 12, 2018
Nothing published for this version
Released January 17, 2018 - Project moved to dr-prodigy - Added tests for Irish calendar - Minor fixes and refactoring
Released January 17, 2018
Released February 12, 2017 - Add Norwegian holidays
Released February 12, 2017
Improve United Kingdom holidays
Released February 2, 2017
Add holidays, extended holidays and tests for Portugal
Released January 12, 2016
Rename project from holidays.py to python-holidays
Released November 18, 2016
holidays remains the sameAdd holidays and tests for Columbia, Denmark, Spain, United Kingdom
Released September 5, 2016
Add federal and provincial holidays for Germany
Released January 5, 2016
Add append and get_list methods to Holiday objects
Released October 4, 2015
append and get_list methods to Holiday objectssum() Holiday objectsFix pip installs when python-dateutil not already present
Released October 9, 2014
Adds federal holidays for Mexico
Released September 4, 2014
default added to get() method to make it behave the same
as dict.get()Each country is now initialized with its own individual class (see examples in README). This is a backward incompatible API change.
Released August 28, 2014
Support for Python 2.5, 2.6, 2.7
Released August 1, 2014
Your coding agent can read these notes before it upgrades. Set up the MCP server →