Code Quality Rank: L5
Programming language: PHP
License: GNU General Public License v3.0 or later
Tags: Date And Time     Time     Date     Calculation     Calendar     Bank     Holiday     Holidays     Celebration     National    
Latest version: v2.5.0

Yasumi alternatives and similar libraries

Based on the "Date and Time" category.
Alternatively, view Yasumi alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Yasumi or a related project?

Add another 'Date and Time' Library



GitHub Release Total Downloads Coding Standard Static analysis Testing [Software License](LICENSE)


Yasumi (Japanese for 'Holiday'「休み」) is the easy PHP library that helps you retrieve the dates and names of holidays and other special celebrations from various countries/states. It is calculation and rule driven avoiding the need of a comprehensive database.

Many services exist that can provide holiday information, however are either not entirely free or only offer limited information. In addition, no exhaustive PHP library exists today covering a wide range of holidays and countries. PEAR's Date_Holidays library was a similar attempt, however it hasn't been updated for a long time.


The goal of Yasumi is to be powerful while remaining lightweight, by utilizing PHP native classes wherever possible. Yasumi's calculation is provider-based (i.e. by country/state), making it easy to add new holiday providers that calculate holidays.

  • Straightforward API
  • Framework-agnostic
  • Use of Providers to easily extend and expand new Holidays
  • Common Holiday Providers
  • Accounts for the date/time when holidays have been officially established and/or abolished
  • Filters enabling to easily select certain holiday types (Official, Observed, Bank, Seasonal or Other)
  • Global Translations
  • Timezone aware
  • Implements ArrayIterator to easily process a provider's holidays
  • Fully documented
  • Fully unit tested
  • Composer ready, PSR-12 and PSR-4 compliant


Yasumi’s documentation is available on https://www.yasumi.dev. You will find all the necessary information how to install Yasumi and also recipes how you can use Yasumi in your project.


Checkout the blog section on documentation site regularly for latest updates. Keeping you informed about any news, releases, etc. in a handy blog post format!


Contributions are encouraged and welcome; I am always happy to get feedback or pull requests on GitHub :) Create Github Issues for bugs and new features and comment on the ones you are interested in.

If you enjoy what I am making, an extra cup of coffee is very much appreciated :). Your support helps me to put more time into Open-Source Software projects like this.


Yasumi is open-source software licensed under the MIT License (MIT). Please see [LICENSE](LICENSE) for more information.

*Note that all licence references and agreements mentioned in the Yasumi README section above are relevant to that project's source code only.