README

Checkdomain/Holiday 是一个用于检查指定日期是否为特定国家节假日的小型库。它还可以告诉您给定日期是全国性的节假日还是仅在某个州内的节假日。

目前支持的国家

checkdomain Holiday 是开源的。如果您使用这个库，我们很乐意得到您对目前尚未实施且您熟悉的国家的支持。Pull requests 将会得到快速审查和合并。

要创建新的 Provider，请参阅 ProviderInterface 接口。

Checkdomain/Holiday 需要 php >= 5.5。

安装这个库最简单的方式是通过 composer。只需将以下行添加到您的 composer.json 文件中

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

另一种方式是下载此库并自行配置自动加载。此库依赖于一个 PSR-4 兼容的自动加载器以进行自动类加载。

要检查节假日，请实例化 Util 类并调用 getHoliday 方法。

$util    = new \Checkdomain\Holiday\Util();
$holiday = $util->getHoliday('DE', '2014-01-01');

如果您只需要知道您的日期是否有节假日，还有一个 isHoliday 方法。

如果您需要知道特定国家的所有节假日，您可以实例化其中一个包含的提供者并调用 getHolidaysByYear 方法。所有提供者都必须遵循 ProviderInterface 接口。

在基本目录中运行 php composer.phar install 命令以安装 phpunit 依赖项。之后，您只需调用 php vendor/bin/phpunit 来运行测试套件。

要运行特定的测试类，请调用 php vendor/bin/phpunit --filter TestClassName