---
id: holidays
version: "0.102"
license: MIT
license_treatment: permissive
maintenance: active
---

# holidays — Open World Holidays Framework

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install holidays
uv add holidays
poetry add holidays

## 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>&nbsp;<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>&nbsp;<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...

## AI interpretation — verify before relying

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

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.

[View on SkillFed](https://skillfed.io/packages/holidays) · [View on PyPI](https://pypi.org/project/holidays/)