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 today
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 observed holidays substitution support (#3289 by @KJhellico)
Released March 2, 2026
New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.91...v0.92
Refactor United Kingdom holidays (#3262 by @KJhellico)
One column per quarter.
Released February 16, 2026
OPTIONAL category (#3260 by @PredictiveManish)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.90...v0.91
Update Armenia holidays: add WORKDAY category and substituted holidays (#3240 by @KJhellico)
Released February 2, 2026
WORKDAY category and substituted holidays (#3240 by @KJhellico)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.89...v0.90
Refactor test_no_holidays, now also test supported_categories by default (#3197 by @PPsyrius, @arkid15r)
Released January 19, 2026
test_no_holidays, now also test supported_categories by default (#3197 by @PPsyrius, @arkid15r)HALF_DAY holidays from 2019 onwards (#3212 by @simongreen-net)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.88...v0.89
Refactor Macau holidays (#3181 by @KJhellico)
Released January 5, 2026
utils::list_long_breaks function to find consecutive holidays (#3001 by @AryaPhansalkar, @arkid15r)DE_FACTO category (#3138 by @vruss)GOVERNMENT) special holidays (#3159 by @KJhellico)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.87...v0.88
Refactor TestAllInSameYear class (#3131 by @PPsyrius, @arkid15r)
Released December 15, 2025
TestAllInSameYear class (#3131 by @PPsyrius, @arkid15r)uv (#3116 by @KJhellico, @arkid15r)uv for dependency management (#3101 by @PPsyrius, @arkid15r, @KJhellico)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.86...v0.87
Introduce HolidayBase::_add_multiday_holiday method (#3059 by @KJhellico, @arkid15r)
Released December 1, 2025
HolidayBase::_add_multiday_holiday method (#3059 by @KJhellico, @arkid15r)HolidayBase methods (#3079 by @KJhellico, @arkid15r)assert{variant}HolidayDatesInYear, assert{variant}HolidaysInYear test methods (#3090 by @PPsyrius, @arkid15r)th l10n typo cleanup (#3097 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.85...v0.86
Refactor l10n scripts (#3063 by @PPsyrius, @arkid15r)
Released November 17, 2025
pyproject.toml (#3053 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.84...v0.85
Update Spain holidays in 2008-2009, 2026 (#3026 by @PPsyrius)
Released November 3, 2025
ChristianHolidays::_add_saint_martins_day method (#3023 by @PPsyrius)th l10n for "{insert} Anniversary of...." (#3027 by @PPsyrius)Full Changelog: https://github.com/vacanza/holidays/compare/v0.83...v0.84
Add _add_observed/_move_holiday's force_observed support (#2986 by @PPsyrius)
Released October 20, 2025
_add_observed/_move_holiday's force_observed support (#2986 by @PPsyrius)HolidayBase::_is_weekday method (#2999 by @PPsyrius, @arkid15r)HolidaySum::__init__ (#3013 by @KJhellico, @arkid15r)th l10n support, refactor test cases (#3011 by @PPsyrius)th l10n, refactor test cases (#3006 by @PPsyrius)WORKDAY for 2026 (#3005 by @KJhellico)WORKDAY category for 2025 onwards (#3004 by @PPsyrius)HALF_DAY, OPTIONAL holidays, th l10n support (#2984 by @PPsyrius, @arkid15r)flake8-boolean-trap (FBT) errors check (#3007 by @KJhellico)Full Changelog: https://github.com/vacanza/holidays/compare/v0.82...v0.83
Add variable weekend support (#2945 by @KJhellico, @arkid15r)
Released October 6, 2025
en_US typo fixed (#2937 by @PPsyrius)start_year to 1911, capitalization fixes (#2942 by @PPsyrius)test_utils.py (#2970 by @PPsyrius)TYPE_CHECKING (#2949 by @KJhellico, @arkid15r)ca) localization (#2960 by @Oriol-Romani-BA, @arkid15r, @KJhellico, @PPsyrius)CHRISTIAN, HEBREW supported categories (#2928 by @PPsyrius)th l10n support (#2959 by @PPsyrius)start_year (#2939 by @PPsyrius)UNOFFICIAL category (#2975 by @PPsyrius)lru_cache with cache (#2964 by @arkid15r, @KJhellico)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.81...v0.82
Add Saint Helena, Ascension and Tristan da Cunha holidays (#2820 by @Abheelash-Mishra, @arkid15r)
Released September 15, 2025
common.py (#2880 by @arkid15r)Full Changelog: https://github.com/vacanza/holidays/compare/v0.80...v0.81
Refactor Australia holidays (#2828 by @KJhellico)
Released September 1, 2025
estimated_label to all countries with Islamic holidays (#2860 by @KJhellico, @arkid15r)TestAllInSameYear methods (#2877 by @KJhellico)common::CommonTests: expand label tests to financial entities (#2876 by @arkid15r)common::TestCase::assertHolidayNameCount method (#2873 by @KJhellico)__init__ method (#2850 by @KJhellico)New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.79...v0.80
Add Bhutan holidays (#2635 by @Prateekshit73, @arkid15r, @code-with-aneesh, @KJhellico, @prateekshit-v)
Released August 18, 2025
ETHIOPIAN_CALENDAR support, Julian Date Drift adjustment pre-1899 and post-2099 (#2794 by @PPsyrius)HolidayBase::is_weekend method (#2780 by @KJhellico, @arkid15r)New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.78...v0.79
Add Pitcairn Islands holidays (#2704 by @Harshil-Gupta, @arkid15r, @KJhellico, @PPsyrius)
Released August 4, 2025
get_nth_working_day (#2770 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.77...v0.78
Refactor US holidays: consolidate duplicate self._year triggers (#2726 by @PPsyrius)
Released July 21, 2025
self._year triggers (#2726 by @PPsyrius)StaticHolidays in some countries (#2729 by @KJhellico)_add_holiday_* pattern (#2721 by @williambdean, @arkid15r)Full Changelog: https://github.com/vacanza/holidays/compare/v0.76...v0.77
Add Bonaire, Sint Eustatius and Saba holidays (#2651 by @Prateekshit73, @arkid15r)
Released July 7, 2025
th l10n (#2642 by @PPsyrius)th l10n (#2678 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.75...v0.76
Refactor TF holidays (#2612 by @KJhellico)
Released June 16, 2025
__init__ method signature (#2618 by @KJhellico)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.74...v0.75
Add Benin holidays (#2562 by @tr33k, @KJhellico)
Released June 2, 2025
New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.73...v0.74
Add Cocos Islands holidays (#2532 by @tr33k)
Released May 19, 2025
Full Changelog: https://github.com/vacanza/holidays/compare/v0.72...v0.73
Add Sao Tome and Principe holidays (#2489 by @tr33k, @arkid15r)
Released May 5, 2025
TestClosestHoliday current date handling (#2517 by @KJhellico)WORKDAY category (#2490 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.71...v0.72
Add French Southern Territories holidays (#2442 by @LuccaAug, @arkid15r)
Released April 21, 2025
New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.70...v0.71
Add iCalendar export support (#2362 by @PPsyrius, @kawazap)
Released April 7, 2025
en_TL, th l10n, update en_US l10n (#2407 by @PPsyrius)HolidayBase::pop_named: add support for more lookup types (#2140 by @wth-d, @KJhellico)_ThaiLunisolar and ThaiCalendarHolidays documentation (#2439 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.69...v0.70
Introduce HolidayBase methods for proper serialization (#2333 by @KJhellico)
Released March 17, 2025
de localization (#2346 by @pyniuX)en_US l10n with China's and Macau's implementation (#2326 by @PPsyrius)BalineseSakaCalendarHolidays (#2328 by @PPsyrius)IslamicHolidays: add an option whether to add estimation label to holiday name (#2298 by @KJhellico)New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.68...v0.69
Fix 2025 Chinese Calendar's Birthday of Buddha (#2310 by @PPsyrius)
Released March 3, 2025
Full Changelog: https://github.com/vacanza/holidays/compare/v0.67...v0.68
Add Saint Lucia holidays (#2266 by @Prateekshit73)
Released February 17, 2025
th l10n typo (#2293 by @PPsyrius)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.66...v0.67
Add Sri Lanka holidays (#2228 by @Prateekshit73, @arkid15r, @KJhellico, @PPsyrius)
Released February 3, 2025
th l10n, exact 2017-2025 entries (#2263 by @PPsyrius)New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.65...v0.66
Update Afghanistan and Iran holidays: change weekend to FRI-SAT and FRI respectively (#2223 by @gio8tisu, @arkid15r)
Released January 20, 2025
New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.64...v0.65
Introduce common.WorkingDayTests class (#2207 by @KJhellico)
Released January 6, 2025
common.WorkingDayTests class (#2207 by @KJhellico)HebrewCalendarHolidays to holidays groups, refactor Israel holidays (#2186 by @KJhellico)New Contributors:
Full Changelog: https://github.com/vacanza/holidays/compare/v0.63...v0.64
Update CI/CD trigger section (#2170 by @arkid15r)
Released December 16, 2024
New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.62...v0.63
Introduce start/end year for entity (#2141 by @KJhellico)
Released December 2, 2024
Full Changelog: https://github.com/vacanza/holidays/compare/v0.61...v0.62
Add financial markets l10n support (#2116 by @KJhellico)
Released November 18, 2024
if len(container)... cases to if container... (#2118 by @arkid15r)TestCase::assertLocalizedHolidays: add subdivisions holidays support (#2117 by @KJhellico)New Contributors
Full Changelog: https://github.com/vacanza/holidays/compare/v0.60...v0.61
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
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
Your coding agent can read these notes before it upgrades. Set up the MCP server →