工作日計算器

工作日計算器用來統計一段日期範圍內真正可用的工作天數，會依選擇的週末規則與手動輸入的假日天數扣除。它適合專案交付估算、請假天數核對、薪資結算、帳期安排、招募流程與合約週期估算。工作日不同於自然日：週六週日休息、週五週六休息、地區國定假日、公司統一休假、補班日與調休日都可能影響答案。此工具提供的是根據輸入條件得到的快速排程估算，不會自動識別各地假日表。若用於人資、法律、財務或正式合約，仍應對照官方日曆與公司制度複核。

工作日數量是指包含起訖日在內的 `[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)，易於閱讀。封閉形式的替代方案計算 `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 個工作日：新年、馬丁路德紀念日、總統日、陣亡將士紀念日、六月節、獨立日、勞動節、哥倫布日、退伍軍人節、感恩節、聖誕節。