/yasumi

Yasumi is an easy PHP Library for calculating national holidays

Primary LanguagePHPOtherNOASSERTION

Logo

GitHub Release Total Downloads Software License Build Status StyleCI Scrutinizer Code Quality

!!Update!! A new blog section has been added to the documentation site. Keeping you informed about any news, releases, etc. in a handy blog post format!

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.

Documentation

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

License

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