Description
# Holidays A fast, efficient Python library for generating country- and subdivision- (e.g. state or province) specific sets of government-designated holidays on the fly. It aims to make determining whether a specific date is a holiday as fast and flexible as possible. <!-- markdownlint-disable MD033 --> <table> <tr> <td>PyPI</td> <td> <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/badge/dynamic/yaml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fvacanza%2Faux%2Frefs%2Fheads%2Fmain%2Fbadges%2Fdownloads%2Fpepy.tech.yaml&query=%24.previous_month_downloads_human&suffix=%2Fmonth&style=flat&label=downloads&color=41B5BE&cacheSeconds=86400" alt="PyPI monthly downloads"></a> <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a> <a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="Latest release date"></a> </td> </tr> <tr> <td>CI/CD</td> <td> <a href="https://github.com/vacanza/holidays/actions/workflows/ci-cd.yml?query=branch%3Adev"><img src="https://img.shields.io/github/actions/workflow/status/vacanza/holidays/ci-cd.yml?branch=dev&color=41B5BE&style=flat" alt="CI/CD status"></a> <a href="https://holidays.readthedocs.io/en/latest/?badge=latest"><img src="https://img.shields.io/readthedocs/holidays?color=41B5BE&style=flat&label=documentation" alt="Documentation build status"></a> <a href="https://security.snyk.io/package/pip/holidays/"><img alt="Open World Holidays Package Health Score" src="https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fsecurity.snyk.io%2Fpackage%2Fpip%2Fholidays%2F&search=(class%3D%22score-number%22.*%3F%3E)(%5Cd%7B1%2C3%7D%2F%5Cd%7B1%2C3%7D)&replace=%242&style=flat&label=snyk&color=41B5BE"></a> </td> </tr> <tr> <td>Code</td> <td> <a href="https://github.com/vacanza/holidays/blob/dev/LICENSE"><img src="https://img.shields.io/github/license/vacanza/holidays?color=41B5BE&style=flat" alt="License"></a> <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/pyversions/holidays?label=python&color=41B5BE&style=flat" alt="Python supported versions"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/badge/style-ruff-41B5BE?style=flat" alt="Code style"></a> <a href="https://app.codecov.io/gh/vacanza/holidays"><img src="https://img.shields.io/codecov/c/github/vacanza/holidays/dev?color=41B5BE&style=flat" alt="Code coverage"></a> </td> </tr> <tr> <td>Docs</td> <td> <a href="https://holidays.readthedocs.io/en/latest/"><img src="https://img.shields.io/badge/documentation-readthedocs.io-41B5BE?style=flat" alt="Documentation on Read the Docs"></a> <a href="https://deepwiki.com/vacanza/holidays"><img src="https://img.shields.io/badge/documentation-deepwiki.com-41B5BE?style=flat" alt="Documentation on DeepWiki"></a> </td> </tr> <tr> <td>GitHub</td> <td> <a href="https://github.com/vacanza/holidays/stargazers"><img src="https://img.shields.io/github/stars/vacanza/holidays?color=41B5BE&style=flat" alt="GitHub stars"></a> <a href="https://github.com/vacanza/holidays/forks"><img src="https://img.shields.io/github/forks/vacanza/holidays?color=41B5BE&style=flat" alt="GitHub forks"></a> <a href="https://github.com/vacanza/holidays/graphs/contributors"><img src="https://img.shields.io/github/contributors/vacanza/holidays?color=41B5BE&style=flat" alt="GitHub contributors"></a> <a href="https://github.com/vacanza/holidays/commits/dev"><img src="https://img.shields.io/github/last-commit/vacanza/holidays/dev?color=41B5BE&style=flat" alt="GitHub last commit"></a> </td> </tr> <tr> <td>Citation</td> <td> <a href="https://doi.org/10.5281/zenodo.14884702"><img src="https://img.shields.io/badge/DOI-10.5281/zenodo.14884702-41B5BE?style=flat" alt="Open World Holidays Framework DOI"></a> </td> </tr> </table> ## Install The latest stable version can always be installed or updated via pip: ``` shell pip install --upgrade holidays ``` The latest development (dev) version can be installed directly from GitHub: ``` shell pip install --upgrade https://github.com/vacanza/holidays/tarball/dev ``` All new features are always first pushed to dev branch, then released on main branch upon official version upgrades. ## Documentation The documentation is hosted on [Read the Docs](https://holidays.readthedocs.io). ## ICS Exports Holiday calendars can be exported as `.ics` files via the [download page](https://holidays.readthedocs.io/en/latest/downloads/). ## Quick Start ``` python from datetime import date import holidays us_holidays = holidays.US() # this is a dict-like object # the below is the same, but takes a string: us_holidays = holidays.countr
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 0.95 | Imported from PyPI (0.95) | Low | 4/21/2026 |
| v0.95 | ## Version 0.95 Released April 20, 2026 - Refactor PO generator for robust metadata and improved class discovery (#3204 by @pareshjoshij, @arkid15r, @KJhellico, @PPsyrius) - Refactor conditional logic using structural pattern matching (PEP 636) (#3518 by @PPsyrius) - Fix typography: replace U+2019 with "'" and U+2013 with '-' (#3539 by @KJhellico) - Update .pre-commit-config.yaml: use SHA for versions (#3516 by @arkid15r) - Update Austria holidays (#3513 by @PPsyrius, @arkid15r) - Upd | High | 4/20/2026 |
| v0.94 | ## Version 0.94 Released April 6, 2026 - Refactor WM archiver script (#3356 by @KJhellico) - Add Hong Kong Stock Exchange holidays (#3440 by @mengChengxi, @arkid15r) - Add Shanghai Stock Exchange (SSE) holidays (#3403 by @mengChengxi, @arkid15r, @KJhellico) - Add Shenzhen Stock Exchange (SZSE) holidays (#3453 by @mengChengxi) - Update Armenia holidays: add ASCII-safe subdivision aliases (#3371 by @Devika9705) - Update Australia holidays: change ANZAC Day holiday in 2026 (ACT) (#3395 b | Medium | 4/6/2026 |
| v0.93 | # Version 0.93 Released March 16, 2026 - Add Germany Stock Exchange holidays (#3271 by @priak388, @krisitachhetry25-hue) - Add Japan Exchange Group (JPX) holidays (#3270 by @adityaanand05, @arkid15r) - Add Kosovo holidays (#3327 by @bleendd, @arkid15r) - Fix l10n tests (#3313 by @KJhellico) - Update CONTRIBUTORS (#3325 by @PPsyrius) - Update Gabon holidays (#3317 by @KJhellico) - Update Gabon holidays: add l10n support (#3178 by @aman-coder03, @KJhellico) - Update India holidays: a | Low | 3/16/2026 |
| v0.92 | # Version 0.92 Released March 2, 2026 - Add observed holidays substitution support (#3289 by @KJhellico) - Update Burkina Faso holidays: add l10n support (#3177 by @aman-coder03, @KJhellico) - Update China holidays: add additional substituted holidays in 2019 (#3294 by @KJhellico) - Update India holidays: add Tamil language support (#3278 by @Abiram08) - Update Iran holidays: add special holidays support (#3304 by @PPsyrius) - Update Kyrgyzstan holidays: add l10n support (#3301 by @KJ | Low | 3/2/2026 |
| v0.91 | # Version 0.91 Released February 16, 2026 - Refactor United Kingdom holidays (#3262 by @KJhellico) - Update Australia holidays: add extra ANZAC Day holiday in NSW (#3273 by @simongreen-net, @arkid15r) - Update Ireland holidays: add `OPTIONAL` category (#3260 by @PredictiveManish) - Update README: fix Snyk badge (#3250 by @KJhellico) - Update United Kingdom holidays: add Jun 15, 2026 holiday in Scotland (#3272 by @KJhellico) - Update dependencies: pre-commit + make update (#3258 by @ar | Low | 2/16/2026 |
| v0.90 | # Version 0.90 Released February 2, 2026 - Update Armenia holidays: add `WORKDAY` category and substituted holidays (#3240 by @KJhellico) - Update Brunei holidays: observed holidays, 2026 exact dates (#3228 by @KJhellico) - Update Germany holidays: add catholic holidays to Augsburg (#3244 by @Estartu) - Update Italy holidays: add Whit Monday in Bolzano (BZ) (#3236 by @KJhellico) - Update WM archiver script: add optional target parameter (#3221 by @pareshjoshij, @arkid15r) - Reference | Low | 2/2/2026 |
| v0.89 | # Version 0.89 Released January 19, 2026 - Refactor `test_no_holidays`, now also test `supported_categories` by default (#3197 by @PPsyrius, @arkid15r) - Update Argentina holidays: add 2026 bridge public holidays (#3210 by @KJhellico) - Update Australia holidays: add Queensland's Christmas Eve `HALF_DAY` holidays from 2019 onwards (#3212 by @simongreen-net) - Update Australia holidays: move Anzac Day in 2026 (ACT) (#3216 by @simongreen-net) - Update Azerbaijan holidays (#3207 by @KJhel | Low | 1/19/2026 |
| v0.88 | # Version 0.88 Released January 5, 2026 - Refactor Macau holidays (#3181 by @KJhellico) - Refactor New Zealand holidays (#3167 by @PPsyrius) - Add Bombay Stock Exchange (BSE) holidays (#3170 by @pareshjoshij) - Add `utils::list_long_breaks` function to find consecutive holidays (#3001 by @AryaPhansalkar, @arkid15r) - Update .po files generator: refresh "PO-Revision-Date" on file changes (#3160 by @KJhellico) - Update Belarus holidays: 2026 substituted holidays (#3183 by @KJhellico) - | Low | 1/5/2026 |
| v0.87 | # Version 0.87 Released December 15, 2025 - Refactor `TestAllInSameYear` class (#3131 by @PPsyrius, @arkid15r) - Refactor tests: long holiday names representation cleanup (#3134 by @KJhellico) - Update Bangladesh holidays: add l10n support (#3117 by @NehaaGaikwad) - Update Chinese calendar: improve Qingming Festival date calculation (#3119 by @KJhellico, @arkid15r) - Update Germany holidays (#3102 by @KJhellico) - Update India holidays: add Gujarati language support (#3130 by @pareshj | Low | 12/15/2025 |
| v0.86 | # Version 0.86 Released December 1, 2025 - Introduce `HolidayBase::_add_multiday_holiday` method (#3059 by @KJhellico, @arkid15r) - Refactor Taiwan holidays (#3077 by @KJhellico) - Refactor some `HolidayBase` methods (#3079 by @KJhellico, @arkid15r) - Fix typography: replace U+2019 with "'" (#3076 by @KJhellico) - Update .readthedocs.yaml: bump OS/Python versions (#3093 by @arkid15r) - Update Bulgaria holidays (#3078 by @KJhellico) - Update Estonia holidays (#3089 by @KJhellico) - U | Low | 12/1/2025 |
| v0.85 | # Version 0.85 Released November 17, 2025 - Refactor l10n scripts (#3063 by @PPsyrius, @arkid15r) - Refactor snapshots generator: ProcessPoolExecutor, UTF-8 support (#3062 by @PPsyrius) - Update Azerbaijan holidays in 2025 (#3060 by @KJhellico) - Update China holidays in 2026 (#3052 by @KJhellico) - Update Ecuador holidays: fix observance rules (#3049 by @PPsyrius) - Update National Stock Exchange of India holidays (#2888 by @saheelsapovadia, @KJhellico) - Update Thailand holidays: a | Low | 11/17/2025 |
| v0.84 | # Version 0.84 Released November 3, 2025 - Update Spain holidays in 2008-2009, 2026 (#3026 by @PPsyrius) - Update Sri Lanka holidays in 2026 (#3033 by @PPsyrius) - Add `ChristianHolidays::_add_saint_martins_day` method (#3023 by @PPsyrius) - Drop Python 3.9 support (#2998 by @PPsyrius) - Standardize `th` l10n for "{insert} Anniversary of...." (#3027 by @PPsyrius) **Full Changelog**: https://github.com/vacanza/holidays/compare/v0.83...v0.84 | Low | 11/3/2025 |
| v0.83 | # Version 0.83 Released October 20, 2025 - Add `_add_observed`/`_move_holiday`'s `force_observed` support (#2986 by @PPsyrius) - Introduce `HolidayBase::_is_weekday` method (#2999 by @PPsyrius, @arkid15r) - Refactor `HolidaySum::__init__` (#3013 by @KJhellico, @arkid15r) - Add Western Sahara holidays (#3003 by @PPsyrius, @arkid15r) - Update Denmark holidays: add `th` l10n support, refactor test cases (#3011 by @PPsyrius) - Update Islamic holidays calculation (#2981 by @KJhellico) - U | Low | 10/20/2025 |
| v0.82 | # Version 0.82 Released October 6, 2025 - Add variable weekend support (#2945 by @KJhellico, @arkid15r) - Refactor Chile holidays: reduce l10n string duplication (#2934 by @PPsyrius) - Refactor Cuba holidays: reduce l10n string duplication (#2935 by @PPsyrius) - Refactor Eastern holidays groups (#2966 by @KJhellico) - Refactor Hungary holidays: reduce l10n string duplication (#2936 by @PPsyrius) - Refactor Japan holidays: reduce l10n string duplication, `en_US` typo fixed (#2937 by @P | Low | 10/6/2025 |
| v0.81 | # Version 0.81 Released September 15, 2025 - Add Saint Helena, Ascension and Tristan da Cunha holidays (#2820 by @Abheelash-Mishra, @arkid15r) - Add Sudan holidays (#2854 by @anshonweb) - Update Chinese Lunisolar calendar: extend Winter Solstice support (#2927 by @KJhellico) - Update Philippines holidays: add 2026 holidays (#2912 by @KJhellico) - Update Spain holidays: add Dec 3 holiday in Navarre (#2895 by @KJhellico) - Update countries with Eastern holidays: add estimated holidays l | Low | 9/15/2025 |
| v0.80 | # Version 0.80 Released September 1, 2025 - Refactor Australia holidays (#2828 by @KJhellico) - Refactor Macau holidays: holiday categories standardization (#2868 by @PPsyrius) - Add Comoros holidays (#2827 by @Prateekshit73, @arkid15r, @prateekshit-v) - Add Eritrea holidays (#2783 by @Prateekshit73, @prateekshit-v) - Add National Stock Exchange of India (NSE) holidays (#2834 by @saheelsapovadia, @arkid15r) - Add Rwanda holidays (#2792 by @Prateekshit73, @prateekshit-v) - Add Somalia | Low | 9/1/2025 |
| v0.79 | # Version 0.79 Released August 18, 2025 - Add Bhutan holidays (#2635 by @Prateekshit73, @arkid15r, @code-with-aneesh, @KJhellico, @prateekshit-v) - Add Gambia holidays (#2777 by @kritibirda26, @arkid15r) - Add Guinea-Bissau holidays (#2776 by @kritibirda26, @arkid15r, @KJhellico) - Add Iraq holidays (#2763 by @kritibirda26, @arkid15r) - Add Kiribati holidays (#2778 by @kritibirda26, @arkid15r) - Add Liberia holidays (#2774 by @kritibirda26) - Add South Georgia and the South Sandwich | Low | 8/18/2025 |
| v0.78 | # Version 0.78 Released August 4, 2025 - Add Pitcairn Islands holidays (#2704 by @Harshil-Gupta, @arkid15r, @KJhellico, @PPsyrius) - Update Egypt holidays (#2742 by @KJhellico) - Update Egypt holidays: update remaining .po files changes (#2748 by @PPsyrius) - Update Germany holidays: add Augsburg Peace Festival for Augsburg (#2750 by @PPsyrius) - Update Indonesia holidays: add August 18, 2025 holiday (#2773 by @KJhellico) - Update Luxembourg holidays: add bank holidays (#2751 by @KJhe | Low | 8/4/2025 |
| v0.77 | # Version 0.77 Released July 21, 2025 - Refactor US holidays: consolidate duplicate `self._year` triggers (#2726 by @PPsyrius) - Add Cabo Verde holidays (#2654 by @Prateekshit73, @prateekshit-v, @sindhuraks) - Add Cayman Islands holidays (#2706 by @Abheelash-Mishra) - Add Central African Republic holidays (#2687 by @Prateekshit73, @arkid15r, @prateekshit-v) - Add Christmas Island holidays (#2623 by @anshonweb, @arkid15r) - Add Democratic Republic of the Congo holidays (#2702 by @Prate | Low | 7/21/2025 |
| v0.76 | # Version 0.76 Released July 7, 2025 - Add Bonaire, Sint Eustatius and Saba holidays (#2651 by @Prateekshit73, @arkid15r) - Add Falkland Islands holidays (#2697 by @Abheelash-Mishra) - Add Libya holidays (#2671 by @kritibirda26) - Add Mauritius holidays (#2643 by @kritibirda26) - Add Mongolia holidays (#2601 by @ankushhKapoor, @arkid15r) - Add Sint Maarten holidays (#2631 by @psupra22, @arkid15r) - Add working day tests for countries with substituted holidays (#2695 by @KJhellico) - | Low | 7/7/2025 |
| v0.75 | # Version 0.75 Released June 16, 2025 - Refactor TF holidays (#2612 by @KJhellico) - Refactor Trinidad and Tobago holidays (#2617 by @PPsyrius) - Refactor `__init__` method signature (#2618 by @KJhellico) - Add Anguilla holidays (#2615 by @Prateekshit73, @arkid15r, @KJhellico) - Add Cook Islands holidays (#2582 by @tr33k, @arkid15r) - Add Guyana holidays (#2614 by @kritibirda26, @arkid15r) - Add Micronesia holidays (#2594 by @nalin-28, @arkid15r, @PPsyrius) - Add Nauru holidays (#26 | Low | 6/16/2025 |
| v0.74 | # Version 0.74 Released June 2, 2025 - Add Benin holidays (#2562 by @tr33k, @KJhellico) - Add Bermuda holidays (#2571 by @kritibirda26) - Add British Virgin Islands holidays (#2555 by @tr33k, @arkid15r) - Add Equatorial Guinea holidays (#2521 by @Abheelash-Mishra) - Add Yemen holidays (#2522 by @Wasif-Shahzad, @arkid15r) - Add Åland Islands holidays. Update Finland holidays (#2537 by @PPsyrius, @arkid15r, @Arynelson) - Update Thailand holidays: add uk localization (#2566 by @KJhellic | Low | 6/2/2025 |
| v0.73 | # Version 0.73 Released May 19, 2025 - Add Cocos Islands holidays (#2532 by @tr33k) - Add Grenada holidays (#2524 by @nalin-28) - Add Nepal holidays (#2386 by @ankushhKapoor, @arkid15r) - Add Togo holidays (#2525 by @Roshan-1024, @KJhellico) - Update Andorra holidays, add l10n support (#2530 by @KJhellico) - Update Argentina holidays: add 2018 G20 Leaders' Summit for Buenos Aires (#2529 by @PPsyrius) - Update Philippines holidays: add special holiday May 12, 2025 (#2539 by @KJhellico | Low | 5/19/2025 |
| v0.72 | # Version 0.72 Released May 5, 2025 - Add Sao Tome and Principe holidays (#2489 by @tr33k, @arkid15r) - Add Trinidad and Tobago holidays (#2402 by @Roshan-1024, @KJhellico) - Fix `TestClosestHoliday` current date handling (#2517 by @KJhellico) - Fix typography: replace U+2019 with "'" and U+2013 with '-' (#2523 by @KJhellico) - Update Canada holidays: add historical holidays (#2507 by @PPsyrius) - Update Ethiopia holidays: official source namings, `WORKDAY` category (#2490 by @PPsyriu | Low | 5/5/2025 |
| v0.71 | # Version 0.71 Released April 21, 2025 - Add French Southern Territories holidays (#2442 by @LuccaAug, @arkid15r) - Add Oman holidays (#2463 by @Wasif-Shahzad) - Add Sierra Leone holidays (#2433 by @SammanSarkar, @arkid15r) - Add Suriname holidays (#2465 by @kritibirda26) - Update .po files generator (#2459 by @KJhellico, @arkid15r) - Update .po files generator (#2470 by @KJhellico) - Update BY.po files (#2452 by @arkid15r) - Update Pakistan holidays: add Youm-e-Takbeer holiday (#24 | Low | 4/21/2025 |
| v0.70 | # Version 0.70 **Released April 7, 2025** - Add iCalendar export support (#2362 by @PPsyrius, @kawazap) - Add Antigua and Barbuda holidays (#2395 by @kritibirda26) - Add Fiji holidays (#2354 by @Prateekshit73, @arkid15r, @kasya, @PPsyrius) - Add Guinea holidays (#2398 by @nalin-28, @arkid15r) - Add Ivory Coast holidays (#2388 by @kritibirda26, @arkid15r) - Add Qatar holidays (#2409 by @Wasif-Shahzad, @arkid15r) - Update Argentina holidays: add categories and subdivisions support (#23 | Low | 4/7/2025 |
| v0.69 | Version 0.69 ============ Released March 17, 2025 - Introduce HolidayBase methods for proper serialization (#2333 by @KJhellico) - Add Macau holidays (#2323 by @PPsyrius) - Update IN holidays and localization (#2259 by @ankushhKapoor, @KJhellico) - Update Poland holidays: add `de` localization (#2346 by @pyniuX) - Fix l10n handling (#2340 by @KJhellico) - Update Hong Kong holidays: standardizes `en_US` l10n with China's and Macau's implementation (#2326 by @PPsyrius) - Update Indone | Low | 3/17/2025 |
| v0.68 | Version 0.68 ============ Released March 3, 2025 - Fix 2025 Chinese Calendar's Birthday of Buddha (#2310 by @PPsyrius) - Update AZ holidays: add 2025 substituted holidays (#2302 by @KJhellico) - Update Kenya holidays, add l10n support (#2316 by @KJhellico) - Update Malaysia holidays (#2309 by @KJhellico) - Update Zenodo record URL in README (#2317 by @KJhellico) - Update issue templates (#2307 by @arkid15r) - Update l10n scripts (#2318 by @KJhellico, @arkid15r) - Add .coderabbit.ya | Low | 3/3/2025 |
| v0.67 | Version 0.67 ============ Released February 17, 2025 - Add Saint Lucia holidays (#2266 by @Prateekshit73) - Add Tuvalu holidays (#2295 by @Prateekshit73, @arkid15r) - Update Greenland holidays l10n (#2288 by @KJhellico) - Update Hong Kong holidays: add l10n support (#2268 by @PPsyrius) - Update Hong Kong holidays: fix `th` l10n typo (#2293 by @PPsyrius) - Update Panama holidays, add l10n support (#2275 by @KJhellico) - Update README: add DOI (#2286 by @arkid15r) - Update United Kin | Low | 2/17/2025 |
| v0.66 | Version 0.66 ============ Released February 3, 2025 - Add Sri Lanka holidays (#2228 by @Prateekshit73, @arkid15r, @KJhellico, @PPsyrius) - Fix typo in CONTRIBUTING.rst (#2264 by @KJhellico) - Update Czechia holidays (#2248 by @KJhellico) - Update Germany holidays: add Corpus Christi in CATHOLIC category (#2253 by @KJhellico) - Update Iceland holidays: add HALF_DAY holidays (#2249 by @KJhellico) - Update Iran holidays (#2234 by @KJhellico) - Update PR exclusion logic (#2233 by @arkid | Low | 2/3/2025 |
| v0.65 | Version 0.65 ============ Released January 20, 2025 - Update Afghanistan and Iran holidays: change weekend to FRI-SAT and FRI respectively (#2223 by @gio8tisu, @arkid15r) - Update Afghanistan holidays (#2221 by @KJhellico) - Update South Korea holidays: 2025 temporary public holidays (#2218 by @YiGeon) - Update ruff from v0.8.6 to v0.9.1 (#2224 by @arkid15r) - Add faster date parsing from strings in ISO 8601 format (#2227 by @KJhellico) - Add signed artifacts path (#2216 by @arkid15r | Low | 1/20/2025 |
| v0.64 | Version 0.64 ============ Released January 6, 2025 - Introduce `common.WorkingDayTests` class (#2207 by @KJhellico) - Refactor XNYS holidays: standardize US market holidays days of mourning entries (#2213 by @PPsyrius) - Add Afghanistan holidays (#2198 by @Prateekshit73, @arkid15r, @PPsyrius) - Add `HebrewCalendarHolidays` to holidays groups, refactor Israel holidays (#2186 by @KJhellico) - Update "Set up Python" to use 3.13 (#2180 by @arkid15r) - Update Belarus holidays: add ru & th | Low | 1/6/2025 |
| v0.63 | Version 0.63 ============ Released December 16, 2024 - Update CI/CD trigger section (#2170 by @arkid15r) - Update KZ holidays: add 2025 special holidays (#2167 by @qaziqarta) - Update Thailand holidays: extend support year down to 1914 (#2166 by @PPsyrius) - Add French subdivision aliases (#2162 by @bors-ltd) - Align financial markets MIC codes with ISO 10383 (#2158 by @KJhellico) - Enforce 100% test coverage (#2173 by @arkid15r) - Inline single-use variables, update .py files forma | Low | 12/16/2024 |
| v0.62 | Version 0.62 ============ Released December 2, 2024 - Introduce start/end year for entity (#2141 by @KJhellico) - Add Guernsey holidays (#2135 by @PPsyrius) - Update AZ holidays: add 2025 special holidays (#2154 by @KJhellico) - Update Argentina holidays: Add 2025 Bridge Public Holidays (#2146 by @PPsyrius) - Update CA holidays: Nunavut Day is NU public holiday since 2020 (#2143 by @KJhellico) - Update Finland holidays: fix Independence Day appearing pre-1917 (#2145 by @PPsyrius) - | Low | 12/2/2024 |
| v0.61 | Version 0.61 ============ Released November 18, 2024 - Add financial markets l10n support (#2116 by @KJhellico) - Refactor some `if len(container)...` cases to `if container...` (#2118 by @arkid15r) - Add "Brasil, Bolsa, Balcão" ([B]³) holidays (#2109 by @araggohnxd, @arkid15r, @KJhellico, @PPsyrius) - Update Brazil holidays, add l10n support (#2113 by @KJhellico) - Update Brunei holidays: 1998-2003, 2006-2025 exact dates (#2107 by @PPsyrius) - Update CH holidays: rename Neujahrestag | Low | 11/18/2024 |
| v0.60 | Version 0.60 ============ Released November 4, 2024 - Refactor Australia tests (#2088 by @KJhellico) - Refactor Cambodia and Laos test cases (#2086 by @PPsyrius) - Refactor Canada tests (#2084 by @KJhellico) - Refactor United States tests (#2087 by @KJhellico) - Refactor v1 incompatibility warning (#2100 by @arkid15r) - Update the Philippines holidays: add `en_PH`, `en_US`, `fil`, `th` localization (#2093 by @PPsyrius, @arkid15r) - Fix `make l10n` removing loc comment for Asarnha Bu | Low | 11/4/2024 |
| v0.59 | Version 0.59 ============ Released October 21, 2024 - Update Vietnam holidays: add `th` localization (#2060 by @PPsyrius) - Update Germany holidays: add Liberation from Nazi Regime Day 2025 in Berlin (#2052 by @hf-kklein, @PPsyrius) - Update Johor (Malaysia) and United Arab Emirates `weekend` observance, cleanup others (#2048 by @PPsyrius) - Update Vietnam holidays (#2049 by @KJhellico) - Update `InternationalHolidays::_add_world_war_two_victory_day()` method (#2064 by @KJhellico) - | Low | 10/21/2024 |
| v0.58 | Version 0.58 ============ Released October 7, 2024 - Add Congo holidays (#2037 by @PPsyrius) - Add Saint Kitts & Nevis holidays (#2005 by @PPsyrius, @arkid15r) - Add Vietnamese translation of VietNam holidays (#2025 by @vunhatchuong, @arkid15r) - Update Kazakhstan holidays: add substituted holidays, localization (#2023 by @KJhellico) - Update Malaysia holidays: add `th` localization (#2030 by @PPsyrius) - Update Singapore holidays: add `en_SG`, `en_US`, `th` localization (#2031 by @P | Low | 10/7/2024 |
| v0.57 | Version 0.57 ============ Released September 16, 2024 - Update Australia holidays: add `en_AU`, `en_US`, `th` localization (#1977 by @PPsyrius) - Fix some docstrings (#1994 by @KJhellico) - Update Australia holidays: fix Christmas Day in ACT (#1986 by @KJhellico) - Update Germany holidays: add `th` localization, deprecated non-standard ISO code, add subdivision aliases (#1979 by @PPsyrius, @arkid15r) - Update Jersey holidays (#1971 by @PPsyrius) - Update South Korea holidays: add Arm | Low | 9/16/2024 |
| v0.56 | Version 0.56 ============ Released September 2, 2024 - Refactor Lao New Year holidays (#1962 by @PPsyrius) - Add 1991-2022 Russian substituted holidays (#1957 by @PPsyrius) - Add Dominica holidays (#1956 by @PPsyrius) - Add Haiti holidays (#1932 by @PPsyrius, @arkid15r) - Change "St." to "Saint" in holidays names (#1966 by @KJhellico) - Update Brunei Darussalam islamic holidays for 2024 (#1937 by @PPsyrius) - Update Cambodian holidays for 2024 (#1936 by @PPsyrius) - Update Dominica | Low | 9/2/2024 |
| v0.55 | Version 0.55 ============ Released August 19, 2024 - Add Samoa holidays (#1914 by @kasya) - Fix misleading France subdivision (#1931 by @MichaelMure) - Update CI/CD: add CodeQL workflow (#1910 by @arkid15r) - Update CI/CD: simplify gh release upload (#1924 by @arkid15r) - Update Github release upload process (#1902 by @arkid15r) - Update SG: add 2025 official holidays (#1903 by @mborsetti, @arkid15r) - Update UA: move martial law holidays to WORKDAY category (#1921 by @KJhellico) - | Low | 8/19/2024 |
| v0.54 | Version 0.54 ============ Released August 5, 2024 - Add Mauritania holidays (#1884 by @kasya) - Fix Malawi tests (#1880 by @arkid15r) - Update CI/CD pip caching (#1866 by @arkid15r) - Update FI: add unofficial holidays (#1885 by @alexei-mobal, @arkid15r) - Update Finland holidays l10n (#1883 by @KJhellico) - Update PR template (#1894 by @arkid15r) - Update RU: add 2025 substituted holidays (#1886 by @Alexeyzhu) - Update docs requirements: revert sphinx to v7.4.7 (#1893 by @arkid15r | Low | 8/5/2024 |
| v0.53 | Version 0.53 ============ Released July 15, 2024 - Update Chile holidays: add bank holidays (#1857 by @KJhellico) - Extend `HolidayBase::__setitem__` to handle names including '; ' (#1858 by @arkid15r) Full Changelog: https://github.com/vacanza/python-holidays/compare/v0.52...v0.53 | Low | 7/15/2024 |
| v0.52 | Version 0.52 ============ Released July 1, 2024 - Update CI/CD: don't cancel concurrent jobs for dev/main/v1 (#1840 by @arkid15r) - Update Italy holidays: add Venice provincial holiday (#1842 by @KJhellico) - Update coverage badge (#1839 by @arkid15r) - Update docs: add years example (#1851 by @arkid15r) - Update v1 incompatibility warning (#1850 by @arkid15r) - Add GitHub issue templates (#1845 by @arkid15r) - Tune up CI/CD jobs concurrency (#1834 by @arkid15r) **Full Changelog* | Low | 7/1/2024 |
| v0.51 | Version 0.51 ============ Released June 17, 2024 - Update Aruba and Curaçao holidays l10n (split locales) (#1827 by @KJhellico) - Update Brazil holidays: add new Nov 20 holiday (#1832 by @KJhellico) - Update CI/CD job concurrency (#1823 by @arkid15r) - Update CI/CD job concurrency (#1830 by @arkid15r) - Update README.rst (#1828 by @arkid15r) - Update ruff configuration (#1819 by @arkid15r) - Align India subdivisions with ISO 3166-2 (#1821 by @KJhellico) - Migrate to codecov.io (#18 | Low | 6/17/2024 |
| v0.50 | Version 0.50 ============ Released June 3, 2024 - Refactor some holidays with uncommon rules (#1807 by @KJhellico) - Add Greenland holidays (#1811 by @Klintrup, @arkid15r) - Fix docs: update Italy docstring (#1808 by @arkid15r) - Update Italy holidays (#1805 by @KJhellico) - Add 2024 Russian Substituted Holidays (#1799 by @PPsyrius) - Add Georgian government holiday for May 17, 2024 (#1802 by @PPsyrius, @arkid15r) - Add v1 future incompatibility warning (#1801 by @arkid15r) - Migra | Low | 6/3/2024 |
| v0.49 | Version 0.49 ============ Released May 20, 2024 - Refactor Laos holidays (#1797 by @KJhellico) - Add IFEU holidays (#1792 by @benjfield, @arkid15r) - Update Hong Kong holidays (#1767 by @KJhellico, @arkid15r) - Update Malaysia holidays (#1791 by @KJhellico) - Update observed rules: add holiday removal support (#1796 by @arkid15r) - Address numpy int argument conversion issue (#1782 by @arkid15r) - Replace `datetime::timedelta` with custom function (#1785 by @KJhellico) **New Cont | Low | 5/20/2024 |
| v0.48 | Version 0.48 ============ Released May 6, 2024 - Introduce workdays calculation support (#1773 by @KJhellico) - Refactor `HolidayBase::__getattr__`: speed up \_add_holiday\_* methods (#1764 by @KJhellico) - Add Palau holidays (#1776 by @PPsyrius, @arkid15r) - Update Greece holidays: move 2024 Labor Day to May 7 (#1786 by @KJhellico) - Update Timor-Leste holidays (#1772 by @KJhellico) - Update United States holidays: fix Confederate Memorial Day in MS (#1775 by @KJhellico) - Update b | Low | 5/6/2024 |
| v0.47 | Version 0.47 ============ Released April 15, 2024 - Refactor some sequential holidays (#1750 by @KJhellico) - Add Jordan holidays (#1746 by @firaskafri, @arkid15r) - Change contributors badge placement (#1753 by @arkid15r) - Update Australia holidays: fix Sovereign's Birthday dates in WA (#1757 by @KJhellico) - Update Eid al-Fitr 2024 dates (#1758 by @KJhellico) - Update European Central Bank holidays (#1754 by @KJhellico) - Update Poland holidays: fix Ascension Day (#1751 by @KJhel | Low | 4/15/2024 |
| v0.46 | Version 0.46 ============ Released April 1, 2024 - Fix Romanian language strings: replace U+015F with proper U+0219 (#1739 by @KJhellico) - Update (c) in file headers and LICENSE (#1672 by @dr-prodigy) - Update Australia holidays (#1736 by @KJhellico) - Update Makefile clean action (#1738 by @arkid15r) - Update US tests: Day After Thanksgiving (#1742 by @arkid15r) - Update United Kingdom holidays: fix observed New Year's Day in Scotland (#1735 by @KJhellico) - Update tests: use asse | Low | 4/1/2024 |
