Skip to content
Check whether a date is a holiday
Branch: master
Clone or download
flogado Merge pull request #43 from libertjeremy/france-alsace-moselle
Holidays for Alsace-Moselle (France)
Latest commit 6543e4c May 6, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Merge pull request #43 from libertjeremy/france-alsace-moselle May 6, 2019
.gitattributes Ignore development files when building packages Sep 27, 2017
.gitignore dont version composer.lock Mar 22, 2015
.travis.yml support more recent versions of phpunit Nov 11, 2018
LICENSE Add: License Aug 25, 2015
composer.json support more recent versions of phpunit Nov 11, 2018

checkdomain Holiday Build Status

Checkdomain/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

  • 🇦🇹 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?

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.


Checkdomain/Holiday requires php >= 5.5.


The easiest way to install this library is through composer. Just add the following lines to your composer.json file:

   "require": {
        "checkdomain/holiday": "~3.0.0"

Another way would be to download this library and configure the autoloading yourself. This library relies on a PSR-4 compatible autoloader for automatic class loading.


To check for holidays just instantiate the Util class and call the getHoliday method.

$util    = new \Checkdomain\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

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

You can’t perform that action at this time.