Code Quality Rank: L5
Monthly Downloads: 32,277
Programming language: PHP
License: MIT License
Tags: Date And Time     Time     Date     Calculation     Calendar     Bank     Holiday     Holidays     Celebration     National    
Latest version: v2.2.0

Yasumi alternatives and similar libraries

Based on the "Date and Time" category

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

Add another 'Date and Time' Library



GitHub Release Total Downloads [Software License](LICENSE) Build Status StyleCI Scrutinizer Code Quality


Yasumi has now its own domain https://www.yasumi.dev and a brand-new documentation website! Thanks to the Jigsaw documentation template created by the amazing TightenCo and TailwindCSS brothers. Read more about it in this blog post: https://www.yasumi.dev/blog/new_docs_site

Please don't forget to update your bookmarks! The documentation site at https://azuyalabs.github.io/yasumi/ will be removed soon.


Yasumi (Japanese for 'Holiday'「休み」) is an easy PHP library to help you calculate the dates and names of holidays and other special celebrations from various countries/states.

Many services exist on the internet that provide holidays, however are either not free or offer only limited information. In addition, no complete PHP library seems to exist today that covers a wide range of holidays and countries, except maybe PEAR's Date_Holidays which unfortunately 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), so it's easy to add new holiday providers that calculate holidays. The methods of Yasumi can be used to get a holiday's date and name in various languages.


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-sourced 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.