A lightweight PHP library for calculating holidays and special celebrations across various countries and states.
Yasumi is a PHP library that calculates and retrieves holiday dates and names for various countries and states. It solves the problem of needing a free, comprehensive, and up-to-date holiday library for PHP applications, replacing outdated or limited alternatives.
PHP developers building applications that require holiday scheduling, event planning, payroll systems, or international date handling.
Developers choose Yasumi because it is lightweight, rule-driven (no database needed), extensible via providers, and fully documented with global translation support, making it a reliable and easy-to-integrate solution.
The easy PHP Library for calculating holidays
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Pure PHP implementation with a straightforward API, making it easy to integrate into any PHP project without external dependencies, as highlighted in the README.
Uses country and state providers to easily add new holidays, allowing for community-driven expansion and customization, as mentioned in the provider-based calculation feature.
Accounts for official establishment and abolition dates of holidays, ensuring correct calculations for past and present years, which is a key feature for reliability.
Supports global translations for holiday names, enabling localized information for international applications, as noted in the global translations highlight.
Coverage depends on community contributions, so some countries or states might be missing or incomplete, which can be a gap for projects requiring comprehensive global data.
Requires PHP 8.2 or higher, excluding legacy systems on older versions, as specified in the requirements, which can be a barrier for upgrades.
Calculations are performed on-the-fly without built-in caching mechanisms, potentially leading to performance overhead for repeated or large-scale queries, unlike database-driven solutions.