國定假日

路徑：/admin/calendar/holidays  |  快捷鍵：0 → Y

管理國定假日設定，用於撥款天數計算（T+N 營業日規則需要排除假日）。

控制列

控制項目	說明
國家	台灣 (TW)（預設）／ Japan (JP) ／ United States (US)
年份	當年 + 未來 2 年，共 3 個選項
匯入國定假日	從外部來源匯入該國家／年份的假日資料（需 calendar.update 權限）
重置	清除該年度所有假日設定（需確認，需 calendar.update 權限）
儲存	儲存已修改的假日設定（需 calendar.update 權限）

控制列下方是顏色圖例（假日 / 週末 / 工作日）與提示文字「點擊日期可切換假日/工作日」。

唯讀檢視

沒有 calendar.update 權限的帳號只會看到日曆與圖例，不會出現匯入、重置、儲存按鈕。

日曆顯示

頁面以 12 個月份卡片呈現整年度日曆：

• 桌面版：3 欄排列（xl）、2 欄排列（md）
• 手機版：單欄排列

每個月份卡片包含：

• 月份標題（月份 + 年份）
• 星期標題列（日、一、二、三、四、五、六）
• 日期格子

日期顏色說明

顏色	說明
🔴 紅底	國定假日（紅色背景、紅色文字）
🔵 藍底	週末（藍色背景、藍色文字）
⚪ 無底色	工作日（灰色 hover 效果）
🟣 主色外框	今天（主色 ring 外框、粗體）

Tooltip 提示

滑鼠移至日期上會顯示提示：

• 假日：顯示假日名稱（如「元旦」），無名稱則顯示「Holiday」
• 週末：顯示「Weekend」
• 工作日：不顯示

切換假日

點擊任一日期即可切換其假日狀態：

• 點擊工作日 → 設為假日
• 點擊假日 → 恢復為工作日
• 點擊時有縮放動畫效果

修改後需點擊「儲存」按鈕才會生效，系統僅儲存有變更的日期。

匯入假日

點擊「匯入國定假日」按鈕，系統會從外部資料來源下載選定國家/年份的國定假日資料，自動標記在日曆上。

TIP

匯入後仍可手動調整個別日期的假日狀態，例如補班日需要手動取消假日標記。

重置假日

點擊「重置」按鈕會清除該年度所有假日設定，操作前需確認。

WARNING

國定假日設定會影響所有使用 T+N（營業日）規則的商戶撥款計算，修改前請確認影響範圍。