holidays

Open World Holidays Framework

holidays Permissive license MIT Active ★ 1,916 v0.102 released 2026-08-03

Install

holidays on PyPI

pip

pip install holidays

uv

uv add holidays

poetry

poetry add holidays

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — python-dateutil
Maintenance	actively maintained — 10 days since the last release
Last repo commit	2026-08-13
First released	2014-08-28
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: holidays-0.102-py3-none-any.whl

Keywords: calendar, holidays, l10n, vacation, worldwide

Development Status :: 4 - BetaIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: End Users/DesktopIntended Audience :: Financial and Insurance IndustryIntended Audience :: Information TechnologyOperating System :: OS IndependentProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonTopic :: File Formats :: JSONTopic :: Office/Business :: Financial :: AccountingTopic :: Office/Business :: Financial :: InvestmentTopic :: Office/Business :: SchedulingTopic :: Software Development :: Libraries :: Python Modules

About holidays

from the package's own PyPI description — quoted content, verbatim

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.

<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...

Read as markdown · JSON record · Source repository · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Generates country- and subdivision-specific holiday calendars on demand, enabling fast lookups to determine whether a given date is a government-designated holiday.

Installs cleanly with a single lightweight runtime dependency (python-dateutil). Actively maintained with a release 10 days old and recent commits; supports Python 3.10–3.14.

MIT license permits unrestricted use, modification, and distribution in both open-source and commercial contexts.

Usage

pip install holidays

import holidays
from datetime import date

us_holidays = holidays.US()
print(date(2015, 1, 1) in us_holidays)  # True
print(us_holidays.get('2015-01-01'))  # "New Year's Day"

Verdict: Well-maintained, permissively licensed library with no known vulnerabilities, minimal install friction, and broad country/subdivision coverage. Suitable for production use in scheduling, financial, and calendar applications.

Needs verification

Performance characteristics for large date ranges or frequent lookups across many countries
Completeness and accuracy of holiday data for all 250 supported country codes

holiday calendar librarycheck if date is holidaycountry holidays pythongovernment holidays by countryholiday lookup by regioninternational holiday datesholiday scheduling tool