{"id":21573916,"url":"https://github.com/checkdomain/holiday","last_synced_at":"2025-04-07T11:06:35.772Z","repository":{"id":12901709,"uuid":"15578811","full_name":"checkdomain/Holiday","owner":"checkdomain","description":"Check whether a date is a holiday","archived":false,"fork":false,"pushed_at":"2023-05-30T14:03:52.000Z","size":155,"stargazers_count":49,"open_issues_count":2,"forks_count":27,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-31T09:07:07.206Z","etag":null,"topics":["checkdomain","holiday","php"],"latest_commit_sha":null,"homepage":"www.checkdomain.de","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/checkdomain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-01-02T08:07:31.000Z","updated_at":"2023-09-19T13:32:52.000Z","dependencies_parsed_at":"2024-06-18T16:53:28.093Z","dependency_job_id":"9a68ce64-54fc-453c-8e3a-e0a790d35be8","html_url":"https://github.com/checkdomain/Holiday","commit_stats":{"total_commits":123,"total_committers":26,"mean_commits":4.730769230769231,"dds":0.6097560975609756,"last_synced_commit":"cb002c0c43dbda27020f59553452dff56c3a59ce"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/checkdomain%2FHoliday","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/checkdomain%2FHoliday/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/checkdomain%2FHoliday/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/checkdomain%2FHoliday/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/checkdomain","download_url":"https://codeload.github.com/checkdomain/Holiday/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640462,"owners_count":20971557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["checkdomain","holiday","php"],"created_at":"2024-11-24T12:08:14.095Z","updated_at":"2025-04-07T11:06:35.751Z","avatar_url":"https://github.com/checkdomain.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# checkdomain Holiday [![Build Status](https://travis-ci.org/checkdomain/Holiday.png?branch=master)](https://travis-ci.org/checkdomain/Holiday)\n\nCheckdomain/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.\n\n\n## Currently supported countries\n\n- 🇦🇹  **AT** Austria\n- 🇧🇪  **BE** Belgium\n- 🇧🇷  **BR** Brazil\n- 🇩🇪  **DE** Germany\n- 🇩🇰  **DK** Denmark\n- 🇪🇪  **EE** Estonia\n- 🇫🇷  **FR** France\n- 🇭🇺  **HU** Hungary\n- 🇮🇹  **IT** Italy\n- 🇱🇹  **LT** Lithuania\n- 🇱🇺  **LU** Luxembourg\n- 🇱🇻  **LV** Latvia\n- 🇳🇴  **NO** Norway\n- 🇵🇱  **PL** Poland\n- 🇵🇹  **PT** Portugal\n- 🇫🇷  **RE** Réunion\n- 🇷🇴  **RO** Romania\n- 🇸🇪  **SE** Sweden\n\n## Your country is not supported?\n\ncheckdomain 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.\n\nTo create a new Provider please see the `ProviderInterface` interface.\n\n\n## Requirements\n\nCheckdomain/Holiday requires php \u003e= 5.5.\n\n\n## Installation\n\nThe easiest way to install this library is through [composer](http://getcomposer.org/). Just add the following lines to your **composer.json** file:\n\n```json\n{\n   \"require\": {\n        \"checkdomain/holiday\": \"~3.0.0\"\n    }\n}\n```\n\nAnother 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.\n\n\n## Usage\n\nTo check for holidays just instantiate the Util class and call the `getHoliday` method.\n\n```php\n$util    = new \\Checkdomain\\Holiday\\Util();\n$holiday = $util-\u003egetHoliday('DE', '2014-01-01');\n```\n\nIf you just need to know if there is a holiday on your date there is a `isHoliday` method, too.\n\nIf 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.\n\n\n## Running Tests\n\nRun 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.\n\nTo run specific test class call `php vendor/bin/phpunit --filter TestClassName`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcheckdomain%2Fholiday","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcheckdomain%2Fholiday","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcheckdomain%2Fholiday/lists"}