[{"data":1,"prerenderedAt":382},["ShallowReactive",2],{"content-zh-TW-getting-started":3},{"doc":4,"debug":352},{"id":5,"title":6,"body":7,"description":23,"extension":346,"meta":347,"navigation":91,"path":348,"seo":349,"stem":350,"__hash__":351},"content\u002Fzh-TW\u002Fgetting-started.md","快速開始",{"type":8,"value":9,"toc":338},"minimark",[10,13,17,46,71,74,134,169,172,238,241,256,259,273,315,318,334],[11,12,6],"h1",{"id":6},[14,15,16],"h2",{"id":16},"安裝",[18,19,24],"pre",{"className":20,"code":21,"language":22,"meta":23,"style":23},"language-bash shiki shiki-themes github-light","dotnet add package Ozakboy.TaiwanKit.TaiwanHolidays\n","bash","",[25,26,27],"code",{"__ignoreMap":23},[28,29,32,36,40,43],"span",{"class":30,"line":31},"line",1,[28,33,35],{"class":34},"s7eDp","dotnet",[28,37,39],{"class":38},"sYBdl"," add",[28,41,42],{"class":38}," package",[28,44,45],{"class":38}," Ozakboy.TaiwanKit.TaiwanHolidays\n",[47,48,49,50,53,54,53,57,53,60,53,63,66,67,70],"p",{},"支援框架：",[25,51,52],{},"netstandard2.0"," \u002F ",[25,55,56],{},"netstandard2.1",[25,58,59],{},"net8.0",[25,61,62],{},"net9.0",[25,64,65],{},"net10.0","（net8+ 提供 ",[25,68,69],{},"DateOnly"," 多載），零執行期依賴、離線可用。",[14,72,73],{"id":73},"基本查詢",[18,75,79],{"className":76,"code":77,"language":78,"meta":23,"style":23},"language-csharp shiki shiki-themes github-light","using Ozakboy.TaiwanKit.TaiwanHolidays;\n\nHolidayCalendar.IsHoliday(new DateTime(2026, 10, 10));   \u002F\u002F true（國慶日）\nHolidayCalendar.IsWorkday(new DateTime(2023, 1, 7));     \u002F\u002F true（補班的週六！）\n\nTaiwanDayInfo info = HolidayCalendar.GetDayInfo(new DateTime(2026, 2, 17));\n\u002F\u002F info.Kind        → DayKind.Holiday\n\u002F\u002F info.Name        → \"春節\"\n\u002F\u002F info.EnglishName → \"Lunar New Year\"\n","csharp",[25,80,81,86,93,99,105,110,116,122,128],{"__ignoreMap":23},[28,82,83],{"class":30,"line":31},[28,84,85],{},"using Ozakboy.TaiwanKit.TaiwanHolidays;\n",[28,87,89],{"class":30,"line":88},2,[28,90,92],{"emptyLinePlaceholder":91},true,"\n",[28,94,96],{"class":30,"line":95},3,[28,97,98],{},"HolidayCalendar.IsHoliday(new DateTime(2026, 10, 10));   \u002F\u002F true（國慶日）\n",[28,100,102],{"class":30,"line":101},4,[28,103,104],{},"HolidayCalendar.IsWorkday(new DateTime(2023, 1, 7));     \u002F\u002F true（補班的週六！）\n",[28,106,108],{"class":30,"line":107},5,[28,109,92],{"emptyLinePlaceholder":91},[28,111,113],{"class":30,"line":112},6,[28,114,115],{},"TaiwanDayInfo info = HolidayCalendar.GetDayInfo(new DateTime(2026, 2, 17));\n",[28,117,119],{"class":30,"line":118},7,[28,120,121],{},"\u002F\u002F info.Kind        → DayKind.Holiday\n",[28,123,125],{"class":30,"line":124},8,[28,126,127],{},"\u002F\u002F info.Name        → \"春節\"\n",[28,129,131],{"class":30,"line":130},9,[28,132,133],{},"\u002F\u002F info.EnglishName → \"Lunar New Year\"\n",[47,135,136,137,140,141,144,145,148,149,152,153,156,157,160,161,168],{},"六種日型分類：",[25,138,139],{},"Workday","（工作日）、",[25,142,143],{},"Weekend","（例假日）、",[25,146,147],{},"Holiday","（國定假日）、",[25,150,151],{},"MakeupHoliday","（補假）、",[25,154,155],{},"AdjustedHoliday","（彈性放假）、",[25,158,159],{},"MakeupWorkday","（補行上班）。",[162,163,164,167],"strong",{},[25,165,166],{},"IsWorkday"," = Workday 或 MakeupWorkday","——補班的週六是工作日。",[14,170,171],{"id":171},"排程輔助",[18,173,175],{"className":76,"code":174,"language":78,"meta":23,"style":23},"\u002F\u002F 跨過春節連假找下一個工作日\nHolidayCalendar.GetNextWorkday(new DateTime(2026, 2, 13));       \u002F\u002F 2026-02-23\n\n\u002F\u002F 區間工作日數（含頭尾）\nHolidayCalendar.CountWorkdays(new DateTime(2026, 2, 1), new DateTime(2026, 2, 28));\n\n\u002F\u002F 連假清單（3 天以上）\nforeach (HolidayPeriod p in HolidayCalendar.GetHolidayPeriods(2026))\n{\n    Console.WriteLine($\"{p.Start:MM\u002Fdd}~{p.End:MM\u002Fdd} 共 {p.TotalDays} 天 {p.Name}\");\n}\n\u002F\u002F 例如 02\u002F14~02\u002F22 共 9 天 春節\n",[25,176,177,182,187,191,196,201,205,210,215,220,226,232],{"__ignoreMap":23},[28,178,179],{"class":30,"line":31},[28,180,181],{},"\u002F\u002F 跨過春節連假找下一個工作日\n",[28,183,184],{"class":30,"line":88},[28,185,186],{},"HolidayCalendar.GetNextWorkday(new DateTime(2026, 2, 13));       \u002F\u002F 2026-02-23\n",[28,188,189],{"class":30,"line":95},[28,190,92],{"emptyLinePlaceholder":91},[28,192,193],{"class":30,"line":101},[28,194,195],{},"\u002F\u002F 區間工作日數（含頭尾）\n",[28,197,198],{"class":30,"line":107},[28,199,200],{},"HolidayCalendar.CountWorkdays(new DateTime(2026, 2, 1), new DateTime(2026, 2, 28));\n",[28,202,203],{"class":30,"line":112},[28,204,92],{"emptyLinePlaceholder":91},[28,206,207],{"class":30,"line":118},[28,208,209],{},"\u002F\u002F 連假清單（3 天以上）\n",[28,211,212],{"class":30,"line":124},[28,213,214],{},"foreach (HolidayPeriod p in HolidayCalendar.GetHolidayPeriods(2026))\n",[28,216,217],{"class":30,"line":130},[28,218,219],{},"{\n",[28,221,223],{"class":30,"line":222},10,[28,224,225],{},"    Console.WriteLine($\"{p.Start:MM\u002Fdd}~{p.End:MM\u002Fdd} 共 {p.TotalDays} 天 {p.Name}\");\n",[28,227,229],{"class":30,"line":228},11,[28,230,231],{},"}\n",[28,233,235],{"class":30,"line":234},12,[28,236,237],{},"\u002F\u002F 例如 02\u002F14~02\u002F22 共 9 天 春節\n",[14,239,240],{"id":240},"年度清單",[18,242,244],{"className":76,"code":243,"language":78,"meta":23,"style":23},"HolidayCalendar.GetHolidays(2026);         \u002F\u002F 該年假日清單（國定假日\u002F補假\u002F彈休）\nHolidayCalendar.GetMakeupWorkdays(2023);   \u002F\u002F 該年補班日清單\n",[25,245,246,251],{"__ignoreMap":23},[28,247,248],{"class":30,"line":31},[28,249,250],{},"HolidayCalendar.GetHolidays(2026);         \u002F\u002F 該年假日清單（國定假日\u002F補假\u002F彈休）\n",[28,252,253],{"class":30,"line":88},[28,254,255],{},"HolidayCalendar.GetMakeupWorkdays(2023);   \u002F\u002F 該年補班日清單\n",[14,257,258],{"id":258},"超出範圍的行為",[47,260,261,262,265,266,272],{},"資料涵蓋 ",[162,263,264],{},"2017-01-01 ～ 2027-12-31","。超出範圍的查詢",[162,267,268,269],{},"一律拋 ",[25,270,271],{},"ArgumentOutOfRangeException","——本套件絕不用「只看週末」猜測。需要優雅處理時：",[18,274,276],{"className":76,"code":275,"language":78,"meta":23,"style":23},"if (HolidayCalendar.TryGetDayInfo(date, out TaiwanDayInfo? info))\n{\n    \u002F\u002F 在範圍內\n}\n\n\u002F\u002F 或事先檢查\nvar min = HolidayCalendar.MinDate;   \u002F\u002F 2017-01-01\nvar max = HolidayCalendar.MaxDate;   \u002F\u002F 2027-12-31\n",[25,277,278,283,287,292,296,300,305,310],{"__ignoreMap":23},[28,279,280],{"class":30,"line":31},[28,281,282],{},"if (HolidayCalendar.TryGetDayInfo(date, out TaiwanDayInfo? info))\n",[28,284,285],{"class":30,"line":88},[28,286,219],{},[28,288,289],{"class":30,"line":95},[28,290,291],{},"    \u002F\u002F 在範圍內\n",[28,293,294],{"class":30,"line":101},[28,295,231],{},[28,297,298],{"class":30,"line":107},[28,299,92],{"emptyLinePlaceholder":91},[28,301,302],{"class":30,"line":112},[28,303,304],{},"\u002F\u002F 或事先檢查\n",[28,306,307],{"class":30,"line":118},[28,308,309],{},"var min = HolidayCalendar.MinDate;   \u002F\u002F 2017-01-01\n",[28,311,312],{"class":30,"line":124},[28,313,314],{},"var max = HolidayCalendar.MaxDate;   \u002F\u002F 2027-12-31\n",[14,316,317],{"id":317},"資料政策",[319,320,321,325,328,331],"ul",{},[322,323,324],"li",{},"唯一來源：行政院人事行政總處「政府行政機關辦公日曆表」（data.gov.tw 開放資料）",[322,326,327],{},"已含 2025《紀念日及節日實施條例》新制假日（教師節、光復節、行憲紀念日、全民勞動節、小年夜）",[322,329,330],{},"每年約 5~6 月官方公告次年行事曆後，以 Minor 版釋出新年度資料",[322,332,333],{},"不含颱風停班（非全國統一）與只紀念不放假的節日",[335,336,337],"style",{},"html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":23,"searchDepth":88,"depth":95,"links":339},[340,341,342,343,344,345],{"id":16,"depth":88,"text":16},{"id":73,"depth":88,"text":73},{"id":171,"depth":88,"text":171},{"id":240,"depth":88,"text":240},{"id":258,"depth":88,"text":258},{"id":317,"depth":88,"text":317},"md",{},"\u002Fzh-tw\u002Fgetting-started",{"title":6,"description":23},"zh-TW\u002Fgetting-started","5D5XGCw5yOHImp0cS5EWSEVMuGdAwGP1I6mwt1zCoM8",{"matched":353,"target":354,"all":355},"fallback (.all() + manual match)","\u002Fzh-TW\u002Fgetting-started",[356,361,366,371,376,381],{"path":357,"id":358,"stem":359,"title":360},"\u002Fen\u002Fapi","content\u002Fen\u002Fapi.md","en\u002Fapi","API Reference",{"path":362,"id":363,"stem":364,"title":365},"\u002Fen\u002Fchangelog","content\u002Fen\u002Fchangelog.md","en\u002Fchangelog","Changelog",{"path":367,"id":368,"stem":369,"title":370},"\u002Fen\u002Fgetting-started","content\u002Fen\u002Fgetting-started.md","en\u002Fgetting-started","Getting Started",{"path":372,"id":373,"stem":374,"title":375},"\u002Fzh-tw\u002Fapi","content\u002Fzh-TW\u002Fapi.md","zh-TW\u002Fapi","API 參考",{"path":377,"id":378,"stem":379,"title":380},"\u002Fzh-tw\u002Fchangelog","content\u002Fzh-TW\u002Fchangelog.md","zh-TW\u002Fchangelog","更新紀錄",{"path":348,"id":5,"stem":350,"title":6},1783231663220]