PHPackages                             azuyalabs/yasumi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. azuyalabs/yasumi

ActiveLibrary[API Development](/categories/api)

azuyalabs/yasumi
================

The easy PHP Library for calculating holidays

2.10.0(3mo ago)1.1k11.4M—0.5%167[4 issues](https://github.com/azuyalabs/yasumi/issues)[3 PRs](https://github.com/azuyalabs/yasumi/pulls)20MITPHPPHP >=8.2CI passing

Since Apr 21Pushed 2w ago14 watchersCompare

[ Source](https://github.com/azuyalabs/yasumi)[ Packagist](https://packagist.org/packages/azuyalabs/yasumi)[ Docs](https://www.yasumi.dev)[ Fund](https://www.buymeacoffee.com/sachatelgenhof)[ RSS](/packages/azuyalabs-yasumi/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (25)Used By (20)

[![GitHub Release](https://camo.githubusercontent.com/910761233fb724cc8038a5792adc464ae44919a612f7911410a6b5b71d14ba35/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f617a7579616c6162732f796173756d692e7376673f7374796c653d666c61742d737175617265)](https://github.com/azuyalabs/yasumi/releases)[![Total Downloads](https://camo.githubusercontent.com/a280afe7e47993b715f341f8e38903f539b949ecc9779b9515bfc75f48403999/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617a7579616c6162732f796173756d692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/azuyalabs/yasumi)[![Coding Standard](https://camo.githubusercontent.com/861d6ffcb0bf4de44dfbfb780de01e8fdb47e06f6031af8eb990b68257f22a75/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617a7579616c6162732f796173756d692f636f64696e672d7374616e646172642e796d6c3f6c6162656c3d436f64696e672532305374616e64617264267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/861d6ffcb0bf4de44dfbfb780de01e8fdb47e06f6031af8eb990b68257f22a75/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617a7579616c6162732f796173756d692f636f64696e672d7374616e646172642e796d6c3f6c6162656c3d436f64696e672532305374616e64617264267374796c653d666c61742d737175617265)[![Static analysis](https://camo.githubusercontent.com/676fbcf1f3cd9c699a693deaee80fead5ef04eeb35dc507e294695d9c2d7e1e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617a7579616c6162732f796173756d692f7374617469632d616e616c797369732e796d6c3f6c6162656c3d537461746963253230616e616c79736973267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/676fbcf1f3cd9c699a693deaee80fead5ef04eeb35dc507e294695d9c2d7e1e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617a7579616c6162732f796173756d692f7374617469632d616e616c797369732e796d6c3f6c6162656c3d537461746963253230616e616c79736973267374796c653d666c61742d737175617265)[![Testing](https://camo.githubusercontent.com/526c3962415725886b1c0aa6e8c3e9cdea070b47afb8cec2f935668e2753cca3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617a7579616c6162732f796173756d692f74657374696e672e796d6c3f6c6162656c3d54657374696e67267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/526c3962415725886b1c0aa6e8c3e9cdea070b47afb8cec2f935668e2753cca3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617a7579616c6162732f796173756d692f74657374696e672e796d6c3f6c6162656c3d54657374696e67267374796c653d666c61742d737175617265)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

[![Logo](https://camo.githubusercontent.com/f8117791b14b9b3c44085f3e6e997666303824fb58e346243e05071e7ea8820c/68747470733a2f2f7777772e796173756d692e6465762f6173736574732f696d672f796173756d695f6c6f676f2e737667)](https://camo.githubusercontent.com/f8117791b14b9b3c44085f3e6e997666303824fb58e346243e05071e7ea8820c/68747470733a2f2f7777772e796173756d692e6465762f6173736574732f696d672f796173756d695f6c6f676f2e737667)

Introduction
------------

[](#introduction)

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](https://pear.php.net/package/Date_Holidays) library was a similar attempt, however it hasn't been updated for a long time.

Requirements
------------

[](#requirements)

Yasumi requires **PHP 8.2** or higher. The library supports PHP 8.2, 8.3, 8.4, and 8.5.

For detailed information about supported PHP versions and security updates, please refer to the [SECURITY.md](SECURITY.md) file.

Installation
------------

[](#installation)

Install Yasumi using [Composer](https://getcomposer.org):

```
composer require azuyalabs/yasumi
```

Quick Start
-----------

[](#quick-start)

Here's a simple example to get you started:

```