工作日计算与节假日扣除：HR 与项目排期实用算法

工作日（Working Day）最基础的定义是：周一至周五，且不是法定假日或特殊放假日。

但这个看似简单的定义在全球实践中差异很大：

• 中国：周一至周五为工作日，法定假日放假，但政府常下令「补班」（周末工作弥补假期）。补班日虽然工作但在计数上通常不算「工作日」，而是作为「工作时间」计入报酬。
• 美国：周一至周五为工作日，法定假日（如感恩节）不工作，没有补班制度。
• 中东与印度：很多国家周五周六为周末，周一至周四加周日为工作日。

中国特色：补班与调休 中国国务院每年发布《假期安排通知》，规定各大节日（春节、清明、端午、中秋、十一黄金周）的放假日期和补班日期。例如 2026 年春节从农历初一放到初六（公历 1 月 29 日至 2 月 3 日），但这段时间会插入周末，所以前后的周六周日需要补班以「抵消」失去的工作日。

结果是：同一个周末日期，有时是工作日（补班），有时不是（正常周末）——这就是为什么需要权威的假期数据库，不能简单地「周六周日都不算」。

中国每年的法定假日固定为 11 天，分别对应 7 个假期：

补班的逻辑： 为了让上班族在春节和十一能充分休息，政府会把假期「拉长」到 7-8 天。但总工作日和总假期加起来要等于 365，所以必须在其他周末补班来平衡。例如春节放 7 天，需要挪用前后两个周末（2 天），再加补班 2 天，最终假期延长。

计算工作日时的注意：

1. 如果日期范围跨越 1 月 24 日，那一天虽然是周六，但实际要工作（算工作日）。
2. 不要混淆「假期日」和「非工作日」——假期日是法定放假，补班日虽然也要上班，但性质不同（可能涉及加班报酬）。
3. 对于年假和考勤，通常「补班日」被当作普通工作日处理，但加班报酬可能不同。

年假计算是 HR 部门最频繁的工作日应用。中国《劳动法》规定：

• 工作 1-10 年：5 天年假
• 工作 10-20 年：10 天年假
• 工作 20+ 年：15 天年假

但「天数」的计算涉及工作日定义。如果员工请年假 5 天，按照：

• 广义理解：5 个自然日（可能包括周末或假期）。
• 法律理解：5 个工作日。

大多数公司采用工作日计算，即请 5 天年假相当于请 5 个法定工作日（周六周日不算，春节等假期另行处理）。

月度考勤计算： 某员工 2026 年 2 月份要统计出勤率。2 月共 28 天，其中：

• 春节假期：2 月 4 日（初六）
• 补班日：无（1 月已补）
• 周末：8 天
• 可工作日数：28 - 1 - 8 = 19 天

如果该员工请了 2 天年假和 1 天病假，实际出勤日数 = 19 - 2 - 1 = 16 天，出勤率 = 16 / 19 = 84%。

坑点警示：

1. 如果公司按自然日计算年假，3 月 3 日至 3 月 8 日共 6 自然日的假期，实际只覆盖 4 个工作日（3 月 7、8 是周末）——员工会吃亏。
2. 补班日的加班报酬往往有特殊规定（如 1.5 倍或 2 倍工资），不能混淆为普通加班。
3. 跨月份的长假（如春节从 1 月 29 日到 2 月 4 日）需要分别计入两个月的考勤。

项目经理制定甘特图时，工作日计算决定了工期预估的准确性。

经典场景： 工程师被分配一个 10 工作日的任务，今天是 2026 年 4 月 25 日（周五）。什么时候能完成？

错误计算： 简单加 10 天 = 5 月 5 日。但这没有排除周末和假期。

正确计算： ``` 2026 年 4 月 25 日至 5 月： - 4 月 25 日（周五）：第 1 个工作日 - 4 月 27、28 日（周一、二）：第 2、3 个工作日 - 4 月 29、30 日（周三、四）：第 4、5 个工作日（注意 4 月 29 日是劳动节）

等等，4 月 29 日是法定假日，需要查表。 ```

完成日期需要用工具自动计算以避免错误。

自动工具的价值： 本站工作日计算工具可以：

1. 快速查询：输入起始日期和工作日数，自动计算结束日期。
2. 包含完整假期数据：内置国务院公布的年度假期安排，包含补班。
3. 排除周末：自动识别周六周日。
4. 生成甘特图友好的格式：导出工作日清单，复制到 Excel、Jira、Monday.com 等工具。

大型项目如有 50+ 人的资源池和 100+ 个任务，手工计算工作日完全不现实。用工具自动化可以减少 90% 的排期错误。

当项目跨越中美两个市场时，工作日计算变成两倍复杂。

中美工作日的交集问题： 假设一个项目由中国团队和美国团队合作，任务的「工作日」应该怎么定义？

• 选项 1：分别计算。中国团队按中国假期，美国团队按美国假期。交接点需要额外协调。
• 选项 2：用「两国都工作的日期」。这意味着只有周一至周五且两国都没有假期的日子才算工作日，工期会大幅延长。
• 选项 3：按交付方的时间。如果交付给中国客户，用中国工作日；反之亦然。

实践建议：

1. 在项目计划书中明确定义「工作日」（哪个国家的标准）。
2. 给予 Buffer：跨国项目的工期估算增加 20-30% 的浮动时间。
3. 使用项目管理工具（Asana、Monday.com）的时区和假期自动映射。
4. 定期同步：当一国有假期时，提前告知对方团队，调整周期性的交接时间。

特殊情况： 中美夏令时切换时间不同（美国 3 月第二周、中国不用）。虽然中国没有 DST，但如果有远程会议时间协议，3 月会议时间需要重新确认。

本站工作日计算工具提供三种查询模式：

1. Web 界面：

1. CSV 导出：

1. HTTP API（适合开发者）：

Response: { "workdayCount": 14, "calendar": [ { "date": "2026-04-25", "isWorkday": true, "holiday": null } ] } ```

集成场景：

• HR 系统：调用 API 自动计算考勤和年假配额。
• 项目管理工具插件：Jira、Asana 的自定义脚本可集成本 API，自动算工期。
• 财务系统：计算月薪时按工作日数调整。

所有计算在浏览器或服务器本地完成，无需上传员工信息，符合隐私规范。