闲社服务运行正常AI智能体自动化平台
c

中国工作日计算

技能标识:chinese-workdays

Calculate legal working days in China according to official government holiday schedules. Uses State Council-published arrangements to exclude weekends, public holidays, and include makeup workdays. Supports date ranges, months, quarters, and full years with automatic holiday calendar management.

作者:admin | 来源记录:ClawHub
登记来源
ClawHub
版本
V 2.0.0
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息,并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限,建议先在隔离环境中运行。
概述
安装方式
版本历史

中国工作日计算

中国工作日计算器

根据中国政府节假日安排计算两个日期之间的工作日数量。

功能特点

  • - 📅 使用国务院发布的官方节假日安排
  • 🔢 计算法定工作日,排除周末和公共假期
  • 📊 支持调休补班
  • 🗂️ 将年度节假日安排存储在简单的YAML数据文件中
  • 🔄 可在新年度节假日安排发布时更新
  • 📊 提供月度与年度统计
  • 🤖 命令行工具,快速计算

快速开始

基础计算

python from chinese_workdays import ChineseWorkdays

calc = ChineseWorkdays()
workdays = calc.count_workdays(2026-01-01, 2026-12-31)
print(f2026年全年工作日: {workdays}天)

月度统计

python marchworkdays = calc.getworkdaysinmonth(2026, 3) # 22天

使用示例

2026年3月有多少个工作日?
2026年第一季度有多少个工作日?
计算2026-02-10至2026-03-20之间的工作日
2026年有多少个工作日?

命令行

bash

快速计算


python workdays_cmd.py 2026-03 # 2026年3月
python workdays_cmd.py 2026-Q1 # 2026年第一季度
python workdays_cmd.py 2026 # 全年
python workdays_cmd.py 2026-01-01 2026-06-30 # 自定义范围

数据格式

节假日安排以YAML格式存储在data/目录中:

yaml
year: 2026
country: China
holidays:
- name: 元旦
start: 2026-01-01
end: 2026-01-03
days_off: [2026-01-01, 2026-01-02] #放假日期
makeup_workdays: [2025-12-28, 2026-01-04] # 调休上班
note: 官方通知原文

更新安排

国务院通常在每年11月发布次年节假日安排。请相应更新YAML文件:

  1. 1. 在https://www.gov.cn/gongbao/查找官方通知
  2. 提取日期和调休上班日
  3. 编辑data/2027.yaml(或相应年份)

实现细节

  • - 使用Python的datetime进行日期运算
  • 节假日数据以YAML格式存储,便于编辑
  • 支持覆盖周末状态的调休上班日
  • 处理跨多天的假期

局限性

  • - 需要为计算的年份定义节假日安排
  • 仅适用于2000年之后的日期(可轻松扩展)
  • 不会自动获取新安排(需手动更新)
  • 数据准确性取决于正确的YAML配置

输出示例

📅 工作日统计
📊 期间: 2026-01-01 至 2026-12-31
📏 总天数: 365
💼 法定工作日: 248 天

工作日占比: 68.0%

📋 期间包含的节假日:
• 元旦: 2026-01-01 ~ 2026-01-03
• 春节: 2026-02-15 ~ 2026-02-23
...

技术说明

计算优先级

  1. 1. 调休上班日(最高优先级)→ 始终计为工作日
  2. 公共假期 → 从工作日中排除
  3. 周末(周六/周日)→ 排除,除非是调休上班日
  4. 常规工作日 → 计为工作日

算法

python
for each day in date_range:
if day in makeup_workdays:
count += 1
elif day in public_holidays:
skip
elif day is weekend:
skip
else:
count += 1

文件结构

chinese-workdays/
├── SKILL.md # 本文件
├── init.py # 包入口
├── chinese_workdays.py # 核心计算引擎
├── workdays_cmd.py # 命令行工具
├── README.md # 用户文档(可选)
└── data/
├── 2026.yaml # 2026年节假日安排(官方)
└── 2027.yaml # 2027年节假日安排(模板)

许可证

MIT许可证 - 可自由使用和修改。

标签

skill ai

通过对话安装

以下为平台配置的接入选项,并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 chinese-workdays-1776058510 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 chinese-workdays-1776058510 技能

通过命令行安装

skillhub install chinese-workdays-1776058510

下载

⬇ 下载 chinese-workdays v2.0.0(免费)

文件大小: 28.26 KB | 发布时间: 2026-4-14 11:53

v2.0.0 最新 2026-4-14 11:53
Complete historical coverage: 21 years of official Chinese holiday data (2007-2019, 2020-2027). Added 2017 (National Day + Mid-Autumn merged). Covers complete evolution from 4-holiday system through 7-holiday revolution, all variations, to modern refinements. Extreme cases: highest 253 workdays (2008), lowest 246 (2017). Production-ready with authoritative government data. Pricing via subscription.json.
返回顶部