README

安装

composer require ricardokovalski/holidays

基本使用

集合

要获取包含所有节假日（包括国内外）和其他日期的集合，只需按照下面的示例操作。

use Holidays\Collections\AllHolidays;

$collection = new AllHolidays();
$collection->getCollection();

现在如果想要一个按日期升序排列的国内节假日集合，请按照下面的示例操作。

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$collection->orderByTimestamp()
    ->ascending()
    ->getCollection();

想知道集合中的第一条记录，只需使用 first() 方法。

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$collection->orderByTimestamp()
    ->ascending()
    ->first();

集合的最后一个记录是？

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$collection->orderByTimestamp()
    ->ascending()
    ->last();

按时间段进行筛选？

use Holidays\Collections\NationalHolidays;

$startDate = \DateTime::createFromFormat('d/m/Y', '01/01/2020');
$endDate = \DateTime::createFromFormat('d/m/Y', '30/06/2020');

$collection = new NationalHolidays();
$collection->between($startDate, $endDate)
    ->orderByTimestamp()
    ->ascending()
    ->getCollection();

获取下一年的节假日？

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays(2021);
$collection->orderByTimestamp()
    ->ascending()
    ->getCollection();

假日

格式化日期的时间戳。

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$holiday = $collection->orderByTimestamp()
    ->ascending()
    ->first();    
    
$holiday->formatter('d/m/Y');

时间推进，获取下一年的节假日日期。

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$holiday = $collection->orderByTimestamp()
    ->ascending()
    ->first();    
    
$holiday->next();

获取去年的节假日日期。

use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$holiday = $collection->orderByTimestamp()
    ->ascending()
    ->first();    
    
$holiday->previous();