TaiwanHolidays
Taiwan national holiday / make-up workday queries — official calendar 2017-2027 embedded, make-up Saturdays handled correctly, scheduling helpers included. Offline, zero dependencies.
Core Features
📅
Official Data Embedded
DGPA government calendar 2017-2027 embedded, incl. the 2025 statutory holiday reform; works offline, yearly minor updates.
🗓️
Make-up Workdays Done Right
Six-way day classification; make-up Saturdays correctly count as workdays — the key difference from weekend-only checks.
⏭️
Scheduling Helpers
Next/previous workday and inclusive workday counting — ready for scheduling and attendance systems.
🏖️
Holiday Periods
Finds 3+ day consecutive breaks (e.g. the 9-day Lunar New Year), cross-year periods untruncated.
Quick Start
1. Install the package
dotnet add package Ozakboy.TaiwanKit.TaiwanHolidays2. Query immediately
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. Scheduling helpers
// 跨過春節連假找下一個工作日
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 天