提供者候選清單
所有資料均來自各供應商自己的頁面，查閱日期為 2026 年 11 月 3 日。假日當天向誰支付多少，取決於勞動法與你的合約，任何 API 都無法回答。Narwhal API 由 Nusantara Ventures, LLC 擁有並營運。
聯準會的 Federal Reserve Financial Services
適合避開聯邦準備銀行休業日，調整美國直接存款發薪日的情境。
比較選項
最符合需求不代表功能相同。請一併查看證據與限制。
| 提供者 | 最適合 | 已查核的證據 | 重要限制 |
|---|---|---|---|
| Narwhal API | 在 37 個涵蓋國家做薪資計算，且外匯、經濟資料或 MCP 共用同一把金鑰時。 | 來源為政府官方資訊。支援依年份、依日期與查詢下一個假日，並附有適用範圍、當地名稱與行政區劃代碼。每個帳戶每月有 $10 免費額度，並包含商業應用使用。 | 國家數量遠少於大型供應商。我們查看的回應中沒有補假日期欄位，工作日需在你自己的程式碼中計算。 |
| Calendarific | 月費低廉，涵蓋國家範圍很廣，並提供地區明細與假日類型。 | 涵蓋 230 多個國家與 3,300 多個地區，所有方案都支援 ISO 3166-2 地點篩選。Starter 每月 $12，或每年 $100，含 10,000 次呼叫。 | 文件中沒有補假日期欄位，也沒有工作日輔助功能。Free 為 500 次呼叫且需要署名，Free 與 Starter 的資料每季更新。 |
| HolidayAPI | 適合需要補假日期、工作日計算與儲存結果權利的多國薪資情境。 | 涵蓋 250 個國家，提供補假日期、/workday 與 /workdays 端點，年份範圍從 1 年到 2050 年以後。Countries 方案每年 $249，每月 1,000,000 次請求，允許商業使用與離線儲存。 | 僅按年計費。地區假日需要每年 $399 的 States & Provinces 方案，免費方案的請求上限未公布。 |
| Nager.Date | 適合原型與內部工具，只要一個無需金鑰、也沒有標明速率限制的免費託管 API 就夠用。 | 程式碼採用 MIT 授權，可用國家端點列出 204 個國家，有包括 Bank 在內的六種假日類型與第一級行政區。我們的探測回傳了 2025 年至 2031 年。 | 條款要求商業使用須積極贊助，但未標明金額。不包含開齋節與宰牲節日期，部分日期被標記為大致或暫定。 |
| Abstract API | 適合已在使用其他 Abstract API，並希望只用一個帶地區條目的假日端點的團隊。 | 涵蓋 190 多個國家與 3,500 多個地區，年份從西元 1 年到 2050 年以後。Free 為 1,000 次請求，每秒 1 次；Standard 按年付費，每月 $99。 | 未說明商業條款。頁面中資料驗證頻率一處寫每週，另一處寫每月，文件中俄羅斯為 RE，巴哈馬為 BH。 |
| date-holidays | 適合希望在行程內使用假日規則、無配額也無網路呼叫的 Node.js 薪資引擎。 | 207 個國家，ISO 3166-2 行政區，五種假日類型，補假日標記以及 isHoliday(date)。3.38.0 版本發布於 2026 年 10 月 24 日。 | 更新需要你自行發布。資料採用帶 ShareAlike 條件的 CC BY-SA 3.0，而 npm 中繼資料列出的是另一個授權字串，因此在儲存衍生資料前請先核對條款。 |
| 聯準會的 Federal Reserve Financial Services | 適合避開聯邦準備銀行休業日，調整美國直接存款發薪日的情境。 | 提供 2026 年至 2030 年的 FedCash 時程，以及含處理截止與恢復時間的 FedACH 表。假日落在週六時，前一個週五聯邦準備銀行照常營業。 | 這是網頁而非 API，且僅涵蓋美元支付系統。需要自行把日期抄到你的表中。 |
按需求選擇
假日落在週末時
記錄了補假日的來源只有兩個。當假日落在週末時，HolidayAPI 會回傳與原日期不同的 observed 日期。date-holidays 會在替代日上標記 substitute。Nager.Date、Calendarific 與 Abstract 的文件中沒有這類欄位，我們查看的 Narwhal 回應裡也沒有。員工是在前一個週五還是後一個週一領薪，取決於你的政策，因此請把這條規則放在假日清單旁邊的表中。
地區假日
Calendarific 在所有方案中都接受 us-ny 或 de-by 這樣的 ISO 3166-2 代碼。HolidayAPI 要做到同樣的事，需要每年 $399 的 States & Provinces 方案。Nager.Date 只到第一級，所以 DE-BW、DE-BY 與 DE-ST 會顯示 Epiphany，但沒有比州更細的劃分。date-holidays 遵循 ISO 3166-2。Narwhal 的條目帶有行政區劃代碼，但在依賴地區資料之前，請先檢查每個國家的 coverage 欄位。
銀行假日、公共假日與紀念日
薪資通常在公共假日發放，紀念日則忽略，因此 type 欄位很重要。Nager.Date 有六種類型，包括 Bank、School 與 Optional。date-holidays 有五種。Calendarific 有四個類別，所有方案都可使用 type 篩選。HolidayAPI 把 public 設為 true 或 false。Abstract 使用自由文字。Narwhal 為每個條目標註適用範圍，例如 federal government 或 national public。
能查詢到多少年之後
休假累積與排班規劃需要提早取得下一年的日曆。HolidayAPI 與 Abstract 都支援到 2050 年及以後。我們對 Nager.Date 的探測回傳了 2025 年至 2031 年，超出該範圍會回報錯誤。Calendarific 只說支援過去與未來的年份，沒有給出具體數字。date-holidays 依規則計算，沒有固定範圍。Narwhal 在路徑中接收年份，所以請先針對每個國家測試你需要的年份。
儲存結果
付費版 HolidayAPI 在訂閱期間允許離線儲存，Free 僅限 24 小時。Nager.Date 的條款禁止營運你自己的假日入口網站，並要求商業使用者贊助。Calendarific 聲明沒有限制，Free 需要署名。date-holidays 的資料採用 CC BY-SA 3.0。Abstract 對此沒有說明。Narwhal 在每個帳戶中都包含商業應用使用；快取之前，請閱讀其價格與條款頁面中關於儲存的部分。
額度或配額用完時
Narwhal 回傳 402 insufficient_credits，不收超額費用，也不計入錯誤請求；免費額度在每月 1 日重置。Calendarific 會統計所有請求，包括錯誤請求，並回傳 429 rate_limit_exceeded。Abstract Free 在額度用完後回傳 422。HolidayAPI 付費方案在每月 1 日 00:00 UTC 重置。為 Narwhal 的所有國家各取一次一年的資料，共 37 次呼叫，約 $0.07。
每 1,000 次呼叫的費用
用方案價格除以包含的呼叫次數，再乘以 1,000。Narwhal Calendars 按呼叫計價，每 1,000 次 $2，沒有方案可除。Calendarific Starter 為 $12 / 10,000 = 按月付費 $1.20，若選年付 $100 的方案則約為 $0.83。HolidayAPI Countries 為 $249 / 12 個月 / 1,000,000，約 $0.02。Abstract Standard 依頁面所載，每月 $99 對應每年 60,000 次請求，即 $1,188 / 60,000 = $19.80。請確認這個單位。
是否為假日及工作日輔助功能
HolidayAPI 提供 /workday（回傳起始日之後 N 個工作日的日期）與 /workdays（統計兩個日期之間的工作日數）。Nager.Date 有查詢下一個假日的呼叫與判斷今天是否為假日的檢查。date-holidays 有 isHoliday(date)。Calendarific 與 Abstract 都沒有。Narwhal 有依日期查詢與查詢下一個假日的呼叫，工作日需在你自己的程式碼中統計，其交割操作指南中有示範。在這些產品裡，只有 Narwhal 被我們確認提供 MCP：一把金鑰可用 80 個工具。
伊斯蘭曆與浮動假日
開齋節與宰牲節的日期取決於月亮觀測。Nager.Date 把 Eid al-Fitr 與 Eid al-Adha 排除在專案之外，並把基於回曆的日期標為大致日期，可能偏差一兩天。對於這些國家的員工，請使用遵循政府公告的來源。Narwhal 讀取政府官方來源，其 MCP 工具包含回曆日期轉換。在向員工承諾日期之前，請逐一核對你發薪的國家。
發薪日與銀行休業
公共假日清單無法告訴你銀行何時處理你的檔案。對於美國直接存款，聯邦準備系統公布了含處理截止與恢復時間的 FedACH 表。假日落在週六時，聯邦準備銀行在前一個週五照常營業；落在週日時，則在隨後的週一休業。請把這張表作為假日 API 之外的第二個輸入，再從發薪日往回倒推。
每個詳細的服務提供者頁面都列出所使用的第一方文件、其證據範圍以及審查日期。 已檢閱: