NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #638 most downloaded on PyPI
Open World Holidays Framework
Latest stable
0.109
Last release 3 days ago
17 Nov 2026
Ships on a steady schedule
a new release about every 8 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
262 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Refactor Australia tests (#2088 by @KJhellico)
Released November 4, 2024
en_PH, en_US, fil, th localization (#2093 by @PPsyrius, @arkid15r)make l10n removing loc comment for Asarnha Bucha (#2091 by @PPsyrius)Adelaide Cup Day holiday pre-1973 for South Australia (#2082 by @PPsyrius)th localization, more refractor (#2097 by @PPsyrius)Full Changelog: https://github.com/vacanza/holidays/compare/v0.59...v0.60
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update Vietnam holidays: add th localization (#2060 by @PPsyrius)
Released October 21, 2024
th localization (#2060 by @PPsyrius)weekend observance, cleanup others (#2048 by @PPsyrius)InternationalHolidays::_add_world_war_two_victory_day() method (#2064 by @KJhellico)holidays package metadata (#2063 by @arkid15r)EasternCalendarHolidays to holidays groups (#2062 by @KJhellico)Full Changelog: https://github.com/vacanza/holidays/compare/v0.58...v0.59
Remove deprecated fix-encoding-pragma, add pyupgrade (#2007 by @PPsyrius, @arkid15r)
Released October 7, 2024
th localization (#2030 by @PPsyrius)en_SG, en_US, th localization (#2031 by @PPsyrius)th localization (#2029 by @PPsyrius)ci label configuration (#2009 by @arkid15r)’ to ' (#2016 by @arkid15r)holidays from python-holidays (#2027 by @arkid15r)fix-encoding-pragma, add pyupgrade (#2007 by @PPsyrius, @arkid15r)New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.57...v0.58
Update Germany holidays: add th localization, deprecated non-standard ISO code, add subdivision aliases (#1979 by @PPsyrius, @arkid15r)
Released September 16, 2024
en_AU, en_US, th localization (#1977 by @PPsyrius)th localization, deprecated non-standard ISO code, add subdivision aliases (#1979 by @PPsyrius, @arkid15r)_ThaiLunisolar calendar support to 2157 (#1981 by @PPsyrius)New Contributors
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.56...v0.57
Migrate deprecated Bosnia-Herzegovina subdivisions to subdivision aliases (#1947 by @PPsyrius)
Released September 2, 2024
numpy test requirements (#1944 by @PPsyrius, @arkid15r)target-version from tool.ruff (#1950 by @arkid15r)EN, MI, HASC) (#1952 by @PPsyrius)Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.55...v0.56
Add Samoa holidays (#1914 by @kasya)
Released August 19, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.54...v0.55
New Contributors
Add Mauritania holidays (#1884 by @kasya)
Released August 5, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.53...v0.54
Update Chile holidays: add bank holidays (#1857 by @KJhellico)
Released July 15, 2024
HolidayBase::__setitem__ to handle names including '; ' (#1858 by @arkid15r)Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.52...v0.53
Update CI/CD: don't cancel concurrent jobs for dev/main/v1 (#1840 by @arkid15r)
Released July 1, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.51...v0.52
Update Aruba and Curaçao holidays l10n (split locales) (#1827 by @KJhellico)
Released June 17, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.50...v0.51
Refactor some holidays with uncommon rules (#1807 by @KJhellico)
Released June 3, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.49...v0.50
Refactor Laos holidays (#1797 by @KJhellico)
Released May 20, 2024
datetime::timedelta with custom function (#1785 by @KJhellico)New Contributors
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.48...v0.49
Introduce workdays calculation support (#1773 by @KJhellico)
Released May 6, 2024
HolidayBase::__getattr__: speed up _add_holiday_* methods (#1764 by @KJhellico)Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.47...v0.48
Refactor some sequential holidays (#1750 by @KJhellico)
Released April 15, 2024
New Contributors
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.46...v0.47
Fix Romanian language strings: replace U+015F with proper U+0219 (#1739 by @KJhellico)
Released April 1, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.45...v0.46
Add Python 3.12 support (#1721 by @arkid15r)
Released March 18, 2024
New Contributors:
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.44...v0.45
Update Ethiopia holidays (#1704 by @KJhellico)
Released March 4, 2024
UNOFFICIAL category for the United States. (#1669 by @PPsyrius)Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.43...v0.44
Introduce subdivisions aliases (#1662 by @sphh, @arkid15r)
Released February 19, 2024:
New Contributors:
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.42...v0.43
Add Ghana holidays (#1639 by @JerryAgbesi, @arkid15r)
Released February 5, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.41...v0.42
Introduce observed_estimated_label (#1633 by @arkid15r)
Released January 15, 2024
New Contributors
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.40...v0.41
Refactor Germany special holidays (#1595 by @KJhellico)
Released January 1, 2024
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.39...v0.40
Refactor holiday categories handling (#1584 by @arkid15r)
Released December 18, 2023
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.38...v0.39
Add categories and subdivisions support to special observed holidays (#1561 by @KJhellico)
Released December 4, 2023
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.37...v0.38
Update Japan holidays: add th localization (#1545 by @PPsyrius)
Released November 20, 2023
_next_year_new_years_day to InternationalHolidays (#1539 by @KJhellico)Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.36...v0.37
Add special holidays per subdivisions support (#1520 by @KJhellico)
Released November 6, 2023
special_holidays to StaticHolidays class (#1519 by @PPsyrius)New Contributors
Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.35...v0.36
Refactor static holidays (#1509 by @arkid15r)
Released October 16, 2023
StaticHolidays (#1513 by @PPsyrius)Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.34...v0.35
Introduce holiday snapshots (#1478 by @arkid15r)
Released October 2, 2023
Full Changelog: https://github.com/vacanza/python-holidays/compare/v.0.33...v0.34
Released October 2, 2023
Add merge queue support (#1464 by @arkid15r)
Released September 18, 2023
New Contributors:
Full Changelog: https://github.com/vacanza/python-holidays/compare/v.0.32...v.0.33
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
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
One column per quarter.