holidays
Open World Holidays Framework
Why this rank:Strong adoptionRecent releaseHealthy release cadence
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 |
|---|---|---|---|
| v0.98 | ## Version 0.98 Released June 1, 2026 - Add NASDAQ (XNAS) holidays (#3586 by @pareshjoshij) - Update United Arab Emirates holidays: fix Thai localization (#3596 by @KJhellico) - Update Bhutan holidays (#3590 by @KJhellico) - Update l10n test: check .po files for missing entries comments (#3594 by @KJhellico) - Add 2025-2026 Islamic holidays exact dates for Indonesia and Philippines (#3591 by @akshiDhi) - Add Tibetan calendar generator (#3330 by @Abiram08, @KJhellico) - Add pre-commit | High | 6/1/2026 |
| v0.97 | ## Version 0.97 Released May 18, 2026 - Refactor calendar generators (#3565 by @KJhellico) - Update Bangladesh holidays: add Islamic holidays (#3531 by @shaonahamed0, @KJhellico, @PPsyrius) - Update CI/CD workflows: set default Python and uv versions (#3581 by @KJhellico) - Update China holidays: update official reference links (#3569 by @nuomi1) - Update European Central Bank holidays: correct historical closures for 1999-2001 (#3572 by @pareshjoshij) - Update India holidays: add Mah | High | 5/18/2026 |
| v0.96 | ## Version 0.96 Released May 4, 2026 - Add static type checking support for `countries` and `financial` aliases (#3549 by @PPsyrius, @arkid15r) - Refactor India holidays testcases (#3524 by @PPsyrius, @arkid15r) - Update .po files generator: use git user identity for "Last-Translator" field (#3553 by @KJhellico) - Update Arabic localization: fix "estimated" and "observed" labels translation (#3551 by @dimssu) - Update Brazil holidays (#3558 by @KJhellico) - Update Germany holidays: ad | High | 5/4/2026 |
| 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.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.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.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.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.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 | Medium | 4/20/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 | Medium | 4/20/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 | Medium | 4/20/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 | Medium | 4/20/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 | Medium | 4/20/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 | Medium | 4/20/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 | Medium | 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 |
Dependencies & License Audit
Loading dependencies...
Similar Packages
More in Frameworks
spec_driven_developSpec-Driven Develop is a platform-agnostic AI agent skill that automates the pre-development workflow for large-scale complex tasks. It is not a framework, not a runtime, not a package manager — it is
deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of ta
tqdmFast, Extensible Progress Meter
simBuild, deploy, and orchestrate AI agents. Sim is the central intelligence layer for your AI workforce.