azuyalabs/yasumi

Health v2 · maintenance only

Adoption not part of the score

1098 stars · 169 forks observed · 2026-09-01

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

Yasumi is a PHP library for calculating the dates and names of holidays and special celebrations for many countries and states. It is rule-driven rather than database-driven, provider-based per country, and includes translations and timezone awareness.

Use cases

• calculate holidays for a country and year in PHP
• check whether a given date is a public holiday
• get localized holiday names in multiple languages
• filter holidays by type such as official, bank, or observed
• add business-day logic that skips national holidays
• extend holiday calculations to a new country or region

When to choose

• you need holiday data in a PHP 8.2+ project without relying on paid or limited external APIs
• you want a framework-agnostic, lightweight, pure-PHP solution
• you need multi-language holiday names and timezone awareness
• you want to add custom country or regional holiday providers

When to avoid

• your project runs on PHP below 8.2
• you need real-time holiday data updates from an external service rather than rule-based calculation
• you need holidays for a country not covered by an existing provider and cannot write one

Facets

library · maturity active

date-time internationalization developer-tools web-development php cross-platform holidays calendar composer provider-based timezone-aware localization

Member repositories

For agents

markdown · JSON · MCP: product_card(name="azuyalabs/yasumi")