Clone or download
Milamber33 and stelgenhof Australian Public Holidays (#112)
Proper handling for (just about) all public holidays in every Australian state and territory.
Latest commit bc1b690 Jun 26, 2018


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.


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


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