PHPackages                             chinese-holidays/holiday-checker - 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. chinese-holidays/holiday-checker

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

chinese-holidays/holiday-checker
================================

A professional PHP library to determine Chinese statutory holidays, working days, and weekends.

v1.0.0(1mo ago)15↓100%MITPHPPHP >=7.4CI passing

Since May 8Pushed 1mo agoCompare

[ Source](https://github.com/arreow/chinese-holidays)[ Packagist](https://packagist.org/packages/chinese-holidays/holiday-checker)[ RSS](/packages/chinese-holidays-holiday-checker/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Chinese Holidays Checker
========================

[](#chinese-holidays-checker)

[![Build Status](https://github.com/arreow/chinese-holidays/actions/workflows/tests.yml/badge.svg)](https://github.com/arreow/chinese-holidays/actions)[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT)

一个专业的 PHP 库，用于准确判断中国法定节假日、工作日及日常周末。

本库包含 2020-2026 年（及后续更新）的中国大陆法定节假日及调休数据，使用 JSON 文件管理每年数据，易于维护和扩展。

功能特性
----

[](#功能特性)

- ✅ 判断任意日期是否为 **法定节假日**
- ✅ 判断任意日期是否为 **工作日**（支持周末调休上班的识别）
- ✅ 判断任意日期是否为 **日常周末**（排除法定节假日及周末调休）
- ✅ 获取节假日详细信息（节假日名称、是否为休息日等）
- ✅ 高性能，按需加载年份数据，自动缓存
- ✅ PSR 标准，100% 单元测试覆盖
- ✅ 独立年份的 JSON 数据文件，易于开源协作更新

环境要求
----

[](#环境要求)

- PHP >= 7.4
- ext-json

安装
--

[](#安装)

使用 Composer 安装：

```
composer require chinese-holidays/holiday-checker
```

快速使用
----

[](#快速使用)

```
use ChineseHolidays\HolidayChecker;

$checker = new HolidayChecker();

// 1. 判断是否为法定节假日（休息日）
$checker->isHoliday('2024-10-01'); // true (国庆节)
$checker->isHoliday('2024-10-12'); // false (国庆调休上班)

// 2. 判断是否为工作日
$checker->isWorkday('2024-10-08'); // true (周二正常上班)
$checker->isWorkday('2024-10-12'); // true (周六调休上班)
$checker->isWorkday('2024-10-01'); // false (国庆节休息)

// 3. 判断是否为日常周末
$checker->isWeekend('2024-01-13'); // true (普通周六)
$checker->isWeekend('2024-10-12'); // false (周六调休上班，非日常周末)

// 4. 获取详细信息
$info = $checker->getHolidayInfo('2024-10-01');
/*
[
    'name' => '国庆节',
    'isOffDay' => true
]
*/
```

数据更新
----

[](#数据更新)

所有节假日数据存放在 `data` 目录下的 JSON 文件中（如 `2024.json`）。每年国务院发布新的放假安排时，只需提交对应年份的 JSON 文件 PR 即可。

JSON 格式示例：

```
{
    "year": 2024,
    "days": {
        "10-01": {"name": "国庆节", "isOffDay": true},
        "10-12": {"name": "国庆节调休", "isOffDay": false}
    }
}
```

贡献指南
----

[](#贡献指南)

请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解如何参与贡献。

许可证
---

[](#许可证)

本项目采用 MIT 许可证开源，详情请见 [LICENSE](LICENSE) 文件。

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance94

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community3

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

33d ago

### Community

---

Top Contributors

[![arreow](https://avatars.githubusercontent.com/u/11517022?v=4)](https://github.com/arreow "arreow (5 commits)")

### Embed Badge

![Health badge](/badges/chinese-holidays-holiday-checker/health.svg)

```
[![Health](https://phpackages.com/badges/chinese-holidays-holiday-checker/health.svg)](https://phpackages.com/packages/chinese-holidays-holiday-checker)
```

PHPackages © 2026

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