vacanza/holidays

Health v2 · maintenance only

Adoption not part of the score

1920 stars · 711 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A fast, efficient Python library for generating country- and subdivision-specific sets of government-designated holidays on the fly. It makes determining whether a specific date is a holiday fast and flexible across a worldwide catalog of regions.

Use cases

• check if a date is a public holiday in a given country
• generate a list of holidays for a state or province
• calculate business days excluding holidays
• build vacation or payroll scheduling logic
• localize holiday names for an international app
• get holidays for a specific year on the fly

When to choose

• you need holiday data for many countries and subdivisions in Python
• you want fast, on-demand holiday calculation without external API calls
• you need localized holiday names and regularly updated rules

When to avoid

• you need non-government or religious observance data beyond official holidays
• you work outside Python or need a hosted holiday API service
• you need historical holiday data far beyond the library's coverage

Facets

library · maturity active

date-time internationalization developer-tools python cross-platform holidays calendar worldwide vacation-planning localization

Member repositories

For agents

markdown · JSON · MCP: product_card(name="vacanza/holidays")