PHPackages proximacode-dev/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. proximacode-dev/holiday ActiveLibrary[Utility & Helpers](/categories/utility) proximacode-dev/holiday ======================= proximacode-dev/Holiday provides a simple class to get holidays for a specified country. This is a fork of checkdomain/Holiday 3.2.2(2y ago)018.5kโ†“27.9%MITPHPPHP >=5.6 Since Aug 27Pushed 2y agoCompare [ Source](https://github.com/proximacode-dev/Holiday)[ Packagist](https://packagist.org/packages/proximacode-dev/holiday)[ RSS](/packages/proximacode-dev-holiday/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (4)Used By (0) proximacode-dev Holiday ======================= [](#proximacode-dev-holiday) proximacode-dev/Holiday is a fork from checkdomain/Holiday 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 - ๐Ÿ‡ง๐Ÿ‡ช **BE** Belgium - ๐Ÿ‡ง๐Ÿ‡ท **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 - ๐Ÿ‡ซ๐Ÿ‡ท **RE** Rรฉunion - ๐Ÿ‡ท๐Ÿ‡ด **RO** Romania - ๐Ÿ‡ธ๐Ÿ‡ช **SE** Sweden Your country is not supported? ------------------------------ [](#your-country-is-not-supported) checkdomain 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) Proximacode-dev/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": { "proximacode-dev/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 \ProximaCode\Holiday\Util(); $holiday = $util->getHoliday('DE', '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 need to know all holidays for a specific country you can instantiate one of the included providers yourself and call the `getHolidaysByYear` method. All providers must follow the `ProviderInterface` interface. 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 27 โ€” LowBetter than 49% of packages Maintenance20 Infrequent updates โ€” may be unmaintained Popularity26 Limited adoption so far Community16 Small or concentrated contributor base Maturity40 Maturing project, gaining track record 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 ~0 days Total 3 Last Release 995d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e8929be324ab9d6b3ec5dfe3160c97c24bea7511d89cfb8cf4b149eda6eccb84?d=identicon)[proximacode-dev](/maintainers/proximacode-dev) --- 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 (30 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)")[![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)")[![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)")[![agilov](https://avatars.githubusercontent.com/u/825624?v=4)](https://github.com/agilov "agilov (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)")[![mpociot](https://avatars.githubusercontent.com/u/804684?v=4)](https://github.com/mpociot "mpociot (1 commits)")[![cmyker](https://avatars.githubusercontent.com/u/1872718?v=4)](https://github.com/cmyker "cmyker (1 commits)")[![jul6art](https://avatars.githubusercontent.com/u/16208295?v=4)](https://github.com/jul6art "jul6art (1 commits)")[![hanzi](https://avatars.githubusercontent.com/u/1106400?v=4)](https://github.com/hanzi "hanzi (1 commits)") --- Tags holiday ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/proximacode-dev-holiday/health.svg) ``` [![Health](https://phpackages.com/badges/proximacode-dev-holiday/health.svg)](https://phpackages.com/packages/proximacode-dev-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)