普贤教程 › 包参考

holidays 包

工作日/节假日历（中国法定节假日）

项	值
包名	`holidays`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`holidays.px`
分类	`时间与日历`
文件数 / 行数	`1 / 296`

安装与引入

bash

pxpkg init          # 首次
pxpkg add holidays@0.2.0
pxpkg install

import holidays

所属分类教程：时间与日历

公开接口

函数	参数
`hd_holidays`	`y`
`hd_workdays`	`y`
`hd_is_workday`	`y, m, d`
`hd_next_workday`	`y, m, d`

其余 13 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`hd_days_from_civil`	`y, m, d`
`hd_is_leap`	`y`
`hd_days_in_month`	`y, m`
`hd_weekday`	`y, m, d`
`hd_weekday_cn`	`y, m, d`
`hd_valid_date`	`y, m, d`
`hd_is_holiday`	`y, m, d`
`hd_next_holiday`	`y, m, d`
`hd_add_days`	`y, m, d, n`
`hd_format`	`y, m, d`
`hd_quarter`	`y, m`
`hd_is_weekend`	`y, m, d`
`hd_diff`	`y1, m1, d1, y2, m2, d2`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/holidays —— 工作日/节假日历（中国法定节假日）
------------------------------------------------------------
纯函数库（无 IO、无状态、自含日期算法），编译（px build）与解释（px run）双模式一致。
hd_is_workday(2025, 10, 1)   → false（国庆，法定假日）
hd_is_workday(2025, 9, 28)   → true （调休上班日）
hd_next_workday(2025, 10, 8) → [2025, 10, 9]
hd_holidays(2025)            → Ok([{m, d, name}, ...]) 当年法定节假日
hd_workdays(2025)            → Ok([{m, d}, ...])       当年调休上班日
日期算法自含（不依赖 datetime 库）：days_from_civil（Hinnant）+ Zeller 取星期。
数据表：2024/2025 中国国务院公布的法定节假日与调休安排（官方口径）。
2026 及以后国务院公布前判为越界 → Err；公布后追加年份。
============================================================
---- 日期算法 ----
1970-01-01 起的天数（Hinnant days_from_civil，仅用于 1970-01-01 之后，正数域安全）