commenthol/date-holidays

Health v2 · maintenance only

Flags: no_releases no_license

Adoption not part of the score

1097 stars · 304 forks observed · 2026-08-28

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

A JavaScript library that calculates public, bank, and observance holidays for 206 countries, their states and regions, with timezone awareness and multi-language holiday names. It supports Gregorian, Islamic, Hebrew, and Chinese calendars and can generate custom holiday rules.

Use cases

• check if a date is a public holiday in a specific country
• get holidays for a state or region with timezone handling
• generate holiday calendars for HR and payroll systems
• localize holiday names in multiple languages
• build an iCal holiday calendar feed
• add custom company holidays alongside official ones

When to choose

• you need worldwide holiday data covering many countries and subdivisions
• you need timezone-aware holiday start/end times
• you need multi-language holiday names or custom holiday rules in JavaScript

When to avoid

• you need exact Islamic holiday dates, which depend on moon sighting
• you need a hosted holiday API rather than an embeddable library
• your stack is not JavaScript/Node.js

Facets

library · maturity active

date-time internationalization sdk developer-tools apis browser cross-platform holidays calendar ical timezone-aware worldwide localization nodejs javascript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="commenthol/date-holidays")