README

Michalmanko/Holiday是一个小型库，用于检查指定日期是否为特定国家的假期。

需求

Michalmanko/Holiday需要PHP 5.3.23或更高版本。

安装

Composer

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

{
   "require": {
        "michalmanko/php-library-holiday": "~1.1.0"
    }
}

手动安装

另一种方法是将此库下载下来，并自行配置自动加载。此库依赖于一个PSR-4兼容的自动加载器以实现自动类加载。

使用方法

获取提供商

$providerByIso = \Michalmanko\Holiday\HolidayFactory::createProvider('PL');
$providerByCountry = \Michalmanko\Holiday\HolidayFactory::createProvider('Poland');
$providerByClassName = \Michalmanko\Holiday\HolidayFactory::createProvider('\\Michalmanko\\Holiday\\Provider\\Poland');

您可以通过两字母的ISO-3166-1国家代码、国家名称或类名来选择提供商。

检查假期

要检查假期，只需为特定国家创建提供商并调用getHolidays方法。

$provider = \Michalmanko\Holiday\HolidayFactory::createProvider('PL');
$holidays = $provider->getHolidays(new \DateTime('2014-01-01'));

如果您只需要知道日期或时间段是否有假期，还有isHoliday和hasHolidays方法。

如果您需要了解特定国家的所有假期，可以调用getHolidaysByYear方法。

许可证

Michalmanko\Holiday遵循MIT许可证，有关更多详细信息，请参阅LICENSE.md文件。

变更日志

有关更多详细信息，请参阅CHANGELOG.md文件。

贡献

Michalmanko/Holiday是开源的。每个人都可以欢迎contribute更多。如果您使用此库，那么得到您熟悉且尚未实现的国家的一些支持将非常棒。拉取请求将被快速审查和合并。

要创建新的提供商，请查看\Michalmanko\Holiday\Provider\Poland类作为示例。

运行测试

在基础目录中运行php composer install命令来安装phpunit依赖项。之后，您可以简单地调用vendor/bin/phpunit -c phpunit.xml.dist来运行测试套件。

michalmanko / php-library-holiday

维护者

详情