工作日计算器

工作日计算器用于统计一个日期范围内真正可用的工作日数量，会按选择的周末规则和手动输入的节假日天数进行扣除。它适合项目交付预估、请假天数核对、薪资结算、账期安排、招聘流程和合同周期估算。工作日和自然日不是一回事：周六周日休息、周五周六休息、地区法定假日、公司统一休假、调休日和补班日都会影响结果。这个工具提供的是基于输入规则的快速排期估算，不会自动识别各地节假日表。用于 HR、法律、财务或正式合同场景时，应再对照官方日历和公司制度复核。

工作日计数是指包含起止日期的区间 `[start, end]` 内，既不是周末也不是节假日的天数。标准的包含端点公式为 `total_days = (end - start) / 86_400_000 + 1`（两个日期均归一化到 UTC 午夜），然后减去周末和节假日天数。星期几通过 `Date.prototype.getDay()` 获取，返回 `0`（周日）到 `6`（周六）——注意一个常见陷阱：`getDay()` 不是 `getDate()`，且结果基于浏览器本地时区，因此跨越午夜的 UTC 日期字符串可能落在与预期不同的星期几上。 周末模式因地区而异：全球默认为周六-周日（西方国家、印度、亚洲大部分地区），但中东历史上使用周四-周五，截至 2024 年大多数海湾国家（阿联酋、巴林、科威特、卡塔尔）已调整为周五-周六或周六-周日（周五半天）。伊朗、阿富汗和南亚部分地区仍仅休周五；以色列休周五-周六。工具提供周六-周日、周五-周六和「无」三种常见预设，其余情况通过节假日天数减法来覆盖。 计数算法本身有两种实用实现方式。朴素迭代法逐日遍历：`for (let d = start; d <= end; d.setDate(d.getDate()+1)) if (![0,6].includes(d.getDay())) count++`，时间复杂度 O(n)（n 为日历天数），代码直观易读。闭合形式的替代方案计算 `full_weeks * 5 + partial_week_workdays`，时间复杂度 O(1)，在跨越多年的时间范围中更有优势。落在周末的节假日不应被重复扣除，因此标准做法是用 `holidays.filter(h => !isWeekend(h)).length` 过滤节假日集合。中国的调休政策增加了一个纯周末模式无法处理的特殊情况：国务院每年发布调休安排，将特定的周六或周日调整为工作日，以补偿春节或国庆的延长假期，因此中国日历的节假日列表必须配合明确的「补班日」列表，而不能仅依赖星期几规则。

• 包含端点公式：`total_days = (end - start) / 86_400_000 + 1`，两个日期均归一化到 UTC 午夜以避免夏令时偏移。
• `Date.prototype.getDay()` 返回 0（周日）到 6（周六），基于浏览器本地时区而非 UTC——时区敏感的代码应使用 `getUTCDay()`。
• 周末预设：周六-周日（西方、印度、亚洲大部分地区）、周五-周六（2006-2013 年起的大多数海湾国家）、仅周五（伊朗）、无（全天候运营）。
• O(1) 闭合形式：`full_weeks * 5 + extra_workdays_in_partial_week`；在跨越多年的时间范围中优于逐日迭代。
• 落在周末的节假日不得重复扣除：应减去 `holidays.filter(h => !isWeekend(h)).length`，而非原始节假日天数。
• 中国国务院调休：某些周六/周日成为法定工作日以补偿延长假期；需要配合明确的补班日列表。
• 美国联邦假日（依据 5 U.S.C. § 6103）每年贡献 11 个工作日：新年、马丁路德金日、总统日、阵亡将士纪念日、六月节、独立日、劳动节、哥伦布日、退伍军人节、感恩节、圣诞节。