TaiwanHolidays

台灣國定假日/補班日查詢——官方行事曆 2017~2027 內嵌、補班週六正確判斷、排程輔助齊全。離線可用、零依賴。

立即安裝查看 GitHub

核心特色

📅

官方資料內嵌

人事行政總處辦公日曆表 2017~2027 內嵌,含 2025 新制假日;離線可用,每年新公告以 Minor 版更新。

🗓️

補班日正確判斷

六種日型分類,補行上班的週六正確判為工作日——這是與「只看週末」的關鍵差異。

⏭️

排程輔助

下一個/上一個工作日、區間工作日計算(含頭尾),排程與考勤系統直接可用。

🏖️

連假查詢

自動找出 3 天以上連續假期(如春節 9 天連假),跨年連假不截斷。

快速開始

1. 安裝套件

dotnet add package Ozakboy.TaiwanKit.TaiwanHolidays

2. 立即查詢

using Ozakboy.TaiwanKit.TaiwanHolidays;

HolidayCalendar.IsHoliday(new DateTime(2026, 10, 10));   // true（國慶日）
HolidayCalendar.IsWorkday(new DateTime(2023, 1, 7));     // true（補班的週六！）

TaiwanDayInfo info = HolidayCalendar.GetDayInfo(new DateTime(2026, 2, 17));
// info.Kind → Holiday, info.Name → "春節"

3. 排程輔助

// 跨過春節連假找下一個工作日
HolidayCalendar.GetNextWorkday(new DateTime(2026, 2, 13));   // 2026-02-23

// 區間工作日數（含頭尾）
HolidayCalendar.CountWorkdays(new DateTime(2026, 2, 1), new DateTime(2026, 2, 28));

// 連假清單（≥3 天）
HolidayCalendar.GetHolidayPeriods(2026);   // 例如 02/14~02/22 春節 9 天