PHPackages cludy-me/holiday - 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. [Utility & Helpers](/categories/utility) 4. / 5. cludy-me/holiday ActiveLibrary[Utility & Helpers](/categories/utility) cludy-me/holiday ================ cludy-me/holiday provides a simple class to get holidays for a specified country 3.1.5(6y ago)08MITPHPPHP >=7.0 Since Mar 23Pushed 6y agoCompare [ Source](https://github.com/cludy-me/holiday)[ Packagist](https://packagist.org/packages/cludy-me/holiday)[ RSS](/packages/cludy-me-holiday/feed)WikiDiscussions master Synced 4d ago READMEChangelogDependencies (1)Versions (19)Used By (0) cludy-me/holiday ================ [](#cludy-meholiday) cludy-me/holiday is a small library to check if a specified date is a holiday in a specific country. It also tells you if the given date is a nation wide holiday or just a holiday in some states. Currently supported countries ----------------------------- [](#currently-supported-countries) - 🇦🇹 **AT** Austria - 🇧🇷 **BR** Brazil - 🇩🇪 **DE** Germany - 🇩🇰 **DK** Denmark - 🇪🇪 **EE** Estonia - 🇫🇷 **FR** France - 🇭🇺 **HU** Hungary - 🇮🇹 **IT** Italy - 🇱🇹 **LT** Lithuania - 🇱🇺 **LU** Luxembourg - 🇱🇻 **LV** Latvia - 🇳🇴 **NO** Norway - 🇵🇱 **PL** Poland - 🇵🇹 **PT** Portugal - 🇷🇴 **RO** Romania - 🇸🇪 **SE** Sweden Your country is not supported? ------------------------------ [](#your-country-is-not-supported) cludy-me/holiday is open source. If you use this library it would be great to get some support for currently not implemented countries which you are familiar with. Pull requests will be reviewed and merged fast. To create a new Provider please see the `ProviderInterface` interface. Requirements ------------ [](#requirements) OpenDroplet/holiday requires php >= 5.5. Installation ------------ [](#installation) The easiest way to install this library is through [composer](http://getcomposer.org/). Just add the following lines to your **composer.json** file: ``` { "require": { "cludy-me/holiday": "~3.0.0" } } ``` Another way would be to download this library and configure the autoloading yourself. This library relies on a [PSR-4](http://www.php-fig.org/psr/psr-4/) compatible autoloader for automatic class loading. Usage ----- [](#usage) To check for holidays just instantiate the Util class and call the `getHoliday` method. ``` $util = new \OpenDroplet\Holiday\Util('LT'); $holiday = $util->getHoliday('2014-01-01'); ``` or ``` $holiday = \OpenDroplet\Holiday\Util::make('LT')->getHoliday('2014-01-01'); ``` If you just need to know if there is a holiday on your date there is a `isHoliday` method, too. If you just need to know if there is a weekend on your date there is a `isWeekend` method, too. If you just need to know if there is a business day on your date there is a `isBusinessDay` method, too. If you need to know all holidays for a specific country: ``` $holidays = \OpenDroplet\Holiday\Util::make('LT')->getHolidays('2014'); ``` Running Tests ------------- [](#running-tests) Run a `php composer.phar install` command in the base directory to install the `phpunit` dependency. After that you can simply call `php vendor/bin/phpunit` to run the test suite. To run specific test class call `php vendor/bin/phpunit --filter TestClassName` ### Health Score 29 — LowBetter than 59% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community16 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~106 days Recently: every ~150 days Total 17 Last Release 2370d ago Major Versions v1.1.0 → v2.0.02015-10-16 2.3.0 → 3.0.02017-09-20 PHP version history (3 changes)v1.0.0PHP >=5.3 3.0.0PHP >=5.5 3.1.5PHP >=7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/36af0a50d77e49245d2c9df3a2d2846eb01b02c2a7215324de4a2393e77580bf?d=identicon)[cludy-me](/maintainers/cludy-me) --- Top Contributors [![wandersonwhcr](https://avatars.githubusercontent.com/u/5286703?v=4)](https://github.com/wandersonwhcr "wandersonwhcr (48 commits)")[![FlorianKoerner](https://avatars.githubusercontent.com/u/647303?v=4)](https://github.com/FlorianKoerner "FlorianKoerner (21 commits)")[![BenjaminPaap](https://avatars.githubusercontent.com/u/396685?v=4)](https://github.com/BenjaminPaap "BenjaminPaap (18 commits)")[![martinlindhe](https://avatars.githubusercontent.com/u/181531?v=4)](https://github.com/martinlindhe "martinlindhe (7 commits)")[![cludy-me](https://avatars.githubusercontent.com/u/33969313?v=4)](https://github.com/cludy-me "cludy-me (7 commits)")[![ickbinhier](https://avatars.githubusercontent.com/u/2810904?v=4)](https://github.com/ickbinhier "ickbinhier (6 commits)")[![kristianlunde](https://avatars.githubusercontent.com/u/569561?v=4)](https://github.com/kristianlunde "kristianlunde (4 commits)")[![Danubio](https://avatars.githubusercontent.com/u/7210403?v=4)](https://github.com/Danubio "Danubio (3 commits)")[![JostBaron](https://avatars.githubusercontent.com/u/2916594?v=4)](https://github.com/JostBaron "JostBaron (3 commits)")[![agilov](https://avatars.githubusercontent.com/u/825624?v=4)](https://github.com/agilov "agilov (2 commits)")[![garak](https://avatars.githubusercontent.com/u/179866?v=4)](https://github.com/garak "garak (2 commits)")[![giorrrgio](https://avatars.githubusercontent.com/u/482501?v=4)](https://github.com/giorrrgio "giorrrgio (2 commits)")[![robertschererc](https://avatars.githubusercontent.com/u/203977391?v=4)](https://github.com/robertschererc "robertschererc (2 commits)")[![vincenttouzet](https://avatars.githubusercontent.com/u/2057992?v=4)](https://github.com/vincenttouzet "vincenttouzet (2 commits)")[![cmyker](https://avatars.githubusercontent.com/u/1872718?v=4)](https://github.com/cmyker "cmyker (1 commits)")[![hanzi](https://avatars.githubusercontent.com/u/1106400?v=4)](https://github.com/hanzi "hanzi (1 commits)")[![mpociot](https://avatars.githubusercontent.com/u/804684?v=4)](https://github.com/mpociot "mpociot (1 commits)") --- Tags holiday ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/cludy-me-holiday/health.svg) ``` [![Health](https://phpackages.com/badges/cludy-me-holiday/health.svg)](https://phpackages.com/packages/cludy-me-holiday) ``` ### Alternatives [geoffreyrose/us-holidays US Holidays Wrapper for the Carbon DateTime Library. 62717.0k2](/packages/geoffreyrose-us-holidays)[checkdomain/holiday Checkdomain/Holiday provides a simple class to get holidays for a specified country 50384.1k2](/packages/checkdomain-holiday)[holidayapi/holidayapi-php Official PHP library for Holiday API 35213.3k1](/packages/holidayapi-holidayapi-php)[citco/carbon This is a wrapper for nesbot/carbon which also calculates which days are British bank holidays (England & Wales only). 17400.1k5](/packages/citco-carbon)[holiday-jp/holiday_jp Japanese holidays 20161.3k](/packages/holiday-jp-holiday-jp)[michalmanko/php-library-holiday A library to calculate holidays 2177.0k1](/packages/michalmanko-php-library-holiday) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)