休假天数计算器

休假天数计算器完整使用指南

根据起止日期计算区间总天数、休息相关天数与工作日近似值。选择 #startDate、#endDate，勾选 #excludeWeekends（默认勾选）可自动排除周六日。可维护自定义假日列表 customHolidays：用 #addHolidayDate 添加，列表 #holidayList 展示并可移除。点计算后显示工作日 #resWorkingDays、总天数 #resTotalDays、非工作相关 #resOffDays，并给出拼假提示 #holidayTips。另有快捷加载按钮辅助。适合请假天数自估与拼假规划，不替代 HR 系统法定年假额度与审批。

计算逻辑理解

• 闭区间按日遍历起止日期（以脚本实现为准，含首尾）。
• 排除周末开启时，周六日不计入工作日。
• 自定义假日按你添加的日期集合扣减或标记。
• 不自动下载国务院节假日 API，法定假需你自行添加日期。
• renderHolidays 排序展示标签；calculate 刷新三项结果与提示文案。

推荐用法

1. 先填计划离开与返回相关日期，确认是否含首尾上班日。
2. 把清明/国庆等放假日与调休上班日分别处理：放假日加入自定义假日；调休上班日不要当假日。
3. 看工作日结果是否超过剩余年假，再决定是否请事假。
4. 拼假提示仅供参考，出游交通与酒店另计。
5. 结果截图附在请假单，最终以 HR 核定为准。

边界

• 无地区差异化日历包，海外团队需自建假日列表。
• 不处理半天假、小时假、时区跨越。
• 调休「周末上班」不会自动识别，除非你的算法仅排除周末——此时工作日可能少算，需人工校正。
• 数据主要在会话内存；刷新可能丢失自定义假日（以页面是否持久化为准）。

常见问题

为什么和同事算的不一样？

首尾是否计入、是否排除周末、假日列表是否一致都会导致差异。

能自动同步国家假日吗？

当前需手动添加假日日期，无云端节假日源。

跨年怎么算？

起止跨年一般仍按连续日期遍历；额度跨年规则问 HR。

和工时表关系？

休假计算器估请假天数；工时表记实际工作投入，二者互补。

拼假实操提示

先查出官方放假与调休安排，把「休」加入自定义假日，把「班」从假日列表排除并在心理上当作工作日。用计算结果比较「请 1 天休 3 天」等方案，再提交系统。工具提示文案不能替代最新政策公告。

自定义假日维护技巧

把全年法定休假日提前批量加入 customHolidays，调休上班日不要加入。列表排序后便于检查遗漏。计算前再核对起止是否含半天——工具按整天模型。快捷加载若提供常见区间，仍以你改后的日期为准。结果三项：总日历跨度、排除后的工作日、休息相关天数，解释请假额度时用工作日更贴近多数公司规则，但仍以 HR 手册为准。

拼假与风险

拼假提示帮助发现「请很少、连休很长」的窗口，但票价与人潮另算。跨境行程注意时差与当地假日不同。不要仅凭提示提前辞职或违纪旷工。截图保存计算结果附在申请单备注。

数据是否持久

若刷新后假日列表消失，说明当前实现偏会话级，请自备假日表下次粘贴添加。排除周末开关变化会显著改工作日，比较方案时保持开关一致。