PHPackages                             darkwind/statutory-holidays-cn - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. darkwind/statutory-holidays-cn

ActiveLibrary[Utility & Helpers](/categories/utility)

darkwind/statutory-holidays-cn
==============================

statutory holidays for china 中国法定节假日/法定工作日

v0.0.2(8y ago)7842[1 issues](https://github.com/dark-wind/statutory-holidays-cn/issues)Apache-2.0PHPPHP >=5.6.4

Since May 5Pushed 7y ago1 watchersCompare

[ Source](https://github.com/dark-wind/statutory-holidays-cn)[ Packagist](https://packagist.org/packages/darkwind/statutory-holidays-cn)[ Docs](https://github.com/dark-wind/statutory-holidays-cn)[ RSS](/packages/darkwind-statutory-holidays-cn/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (3)Used By (0)

statutory-holidays-cn
=====================

[](#statutory-holidays-cn)

statutory holidays for china 中国法定节假日

默认只有18年的

安装
--

[](#安装)

```
composer require darkwind/statutory-holidays-cn

```

栗子
--

[](#栗子)

```
use Holiday\Holiday;

//判断是否为假期
Holiday::isHoliday('20180501');
    [
         "result" => "yes",
         "info" => [
           "day" => "20180501",
           "holiday" => "劳动节",
           "holiday_remark" => "4月29日至5月1日放假调休，共3天。4月28日（星期六）上班",
           "begin" => "",
           "end" => "",
         ],
    ]

Holiday::isHoliday('20180502');
    [
         "result" => "no",
         "info" => [
           "day" => "20180502",
           "holiday" => "",
           "holiday_remark" => "",
           "begin" => "",
           "end" => "",
         ],
    ]

//判断是否为工作日
Holiday::isWorkday('20180501');
Holiday::isWorkday('20180502');
Holiday::isWorkday('20180505');

//2个日期间有多少个假日
Holiday::holidays('20180301', '20180601');
Holiday::holidays('20180421', '20180502');
[
     "date" => [
       [
         "day" => "20180421",
         "holiday" => "",
         "holiday_remark" => "",
         "begin" => "",
         "end" => "",
       ],
       [
         "day" => "20180422",
         "holiday" => "",
         "holiday_remark" => "",
         "begin" => "",
         "end" => "",
       ],
       [
         "day" => "20180429",
         "holiday" => "劳动节",
         "holiday_remark" => "4月29日至5月1日放假调休，共3天。4月28日（星期六）上班",
         "begin" => "",
         "end" => "",
       ],
       [
         "day" => "20180430",
         "holiday" => "劳动节",
         "holiday_remark" => "4月29日至5月1日放假调休，共3天。4月28日（星期六）上班",
         "begin" => "",
         "end" => "",
       ],
       [
         "day" => "20180501",
         "holiday" => "劳动节",
         "holiday_remark" => "4月29日至5月1日放假调休，共3天。4月28日（星期六）上班",
         "begin" => "",
         "end" => "",
       ],
     ],
     "count" => 5,
]

//追加星期信息
Holiday::isHolidayWithAppend('20180501');
[
     "result" => "no",
     "info" => [
       "day" => "20180502",
       "holiday" => "",
       "holiday_remark" => "",
       "begin" => "",
       "end" => "",
       "weekDay" => "6",
       "cn" => "周六",
       "en" => "Saturday",
     ],
]
```

扩展
--

[](#扩展)

```
暂时只支持返回数组，需要其他格式请继承并重载 src/Response.php
自定义节假日或增加其他年份假期，请自行修改config/custom.php

```

测试
--

[](#测试)

```
cd tests
php test.php
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

2930d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9c39e2c24342692caa9c4921df2bf1c6362c6c8d3f13b12ba735ec7a55f73132?d=identicon)[dark-wind](/maintainers/dark-wind)

---

Top Contributors

[![iwiilbeback](https://avatars.githubusercontent.com/u/3671113?v=4)](https://github.com/iwiilbeback "iwiilbeback (2 commits)")

---

Tags

chineseholidayphpworkdayphpdateholidayChineseworkday

### Embed Badge

![Health badge](/badges/darkwind-statutory-holidays-cn/health.svg)

```
[![Health](https://phpackages.com/badges/darkwind-statutory-holidays-cn/health.svg)](https://phpackages.com/packages/darkwind-statutory-holidays-cn)
```

###  Alternatives

[dater/dater

Compact PHP library for working with date/time in different formats & timezones.

14282.3k](/packages/dater-dater)[zjkal/time-helper

一个简单快捷的PHP日期时间助手类库。 a smart PHP datetime helper library.

21128.6k1](/packages/zjkal-time-helper)[wilon/php-number2chinese

PHP数字转为汉字描述、人民币大写方法。

14632.0k1](/packages/wilon-php-number2chinese)[maherelgamil/arabicdatetime

Easy and useful tool to generate arabic or hijri date with multi-language support for laravel

414.5k](/packages/maherelgamil-arabicdatetime)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)