---
title: "工作日 API：7個比較與算法 | Narwhal API"
description: "有工作日 API 嗎？用國定假日清單從平日扣除。比較7個假日來源，附 Python 函式，適用薪資與請假計算。"
url: "https://narwhalapi.com/zh-tw/compare/working-days-apis"
---

# 工作日 API：依國家計算工作日

薪資軟體需要依國家與地區劃分的公共假日、假日落在週末時的明確處理方式，以及允許儲存結果的條款。Calendarific、HolidayAPI 與 Abstract 涵蓋的國家遠多於 Narwhal 的 91 個。Nager.Date 可免費試用，但要求商業使用者贊助。

## 決策

如果你在多個國家發薪，需要補假日期、工作日端點以及儲存結果的權利，並希望以單一年費取得，請選 HolidayAPI。想以每月 $12 起步，選 Calendarific。想在行程內使用 JavaScript 且沒有配額限制，選 date-holidays。如果你的國家在 Narwhal 的 91 個之內，並且希望用一把金鑰呼叫外匯、經濟資料與 MCP，請選 Narwhal。

## 提供者候選清單

所有資料均來自各供應商自己的頁面，查閱日期為 2026 年 11 月 3 日。假日當天向誰支付多少，取決於勞動法與你的合約，任何 API 都無法回答。本頁面由 Narwhal 發布。

### Narwhal API

在 91 個涵蓋國家做薪資計算，且外匯、經濟資料或 MCP 共用同一把金鑰時。

[探索 Narwhal 產品](https://narwhalapi.com/zh-tw/api/calendars/holidays.md)

### Calendarific

月費低廉，涵蓋國家範圍很廣，並提供地區明細與假日類型。

[閱讀詳細比較](https://narwhalapi.com/zh-tw/compare/calendarific.md)

### HolidayAPI

適合需要補假日期、工作日計算與儲存結果權利的多國薪資情境。

[閱讀詳細比較](https://narwhalapi.com/zh-tw/compare/holidayapi.md)

### Nager.Date

適合原型與內部工具，只要一個無需金鑰、也沒有標明速率限制的免費託管 API 就夠用。

[閱讀詳細比較](https://narwhalapi.com/zh-tw/compare/nager-date.md)

### Abstract API

適合已在使用其他 Abstract API，並希望只用一個帶地區條目的假日端點的團隊。

[閱讀詳細比較](https://narwhalapi.com/zh-tw/compare/abstract-api.md)

### date-holidays

適合希望在行程內使用假日規則、無配額也無網路呼叫的 Node.js 薪資引擎。

[閱讀詳細比較](https://narwhalapi.com/zh-tw/compare/date-holidays.md)

### 聯準會的 Federal Reserve Financial Services

適合避開聯邦準備銀行休業日，調整美國直接存款發薪日的情境。

## 比較選項

最符合需求不代表功能相同。請一併查看證據與限制。

| 提供者 | 最適合 | 已查核的證據 | 重要限制 |
| --- | --- | --- | --- |
| Narwhal API | 在 91 個涵蓋國家做薪資計算，且外匯、經濟資料或 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 個工具。

[比較提供者](https://narwhalapi.com/zh-tw/compare/stock-market-holiday-apis.md)

### 伊斯蘭曆與浮動假日

開齋節與宰牲節的日期取決於月亮觀測。Nager.Date 把 Eid al-Fitr 與 Eid al-Adha 排除在專案之外，並把基於回曆的日期標為大致日期，可能偏差一兩天。對於這些國家的員工，請使用遵循政府公告的來源。Narwhal 讀取政府官方來源，其 MCP 工具包含回曆日期轉換。在向員工承諾日期之前，請逐一核對你發薪的國家。

### 發薪日與銀行休業

公共假日清單無法告訴你銀行何時處理你的檔案。對於美國直接存款，聯邦準備系統公布了含處理截止與恢復時間的 FedACH 表。假日落在週六時，聯邦準備銀行在前一個週五照常營業；落在週日時，則在隨後的週一休業。請把這張表作為假日 API 之外的第二個輸入，再從發薪日往回倒推。

[比較提供者](https://narwhalapi.com/zh-tw/compare/stock-market-holiday-apis.md)

每個詳細的服務提供者頁面都列出所使用的第一方文件、其證據範圍以及審查日期。 已檢閱: 2026-11-03

## 來源與評測日期

- [Calendarific 證據和來源](https://narwhalapi.com/zh-tw/compare/calendarific.md)
- [HolidayAPI 證據和來源](https://narwhalapi.com/zh-tw/compare/holidayapi.md)
- [Nager.Date 證據和來源](https://narwhalapi.com/zh-tw/compare/nager-date.md)
- [Abstract API 證據和來源](https://narwhalapi.com/zh-tw/compare/abstract-api.md)
- [date-holidays 證據和來源](https://narwhalapi.com/zh-tw/compare/date-holidays.md)
- [價格 Narwhal API 定價 (narwhalapi.com)](https://narwhalapi.com/pricing.md)
- [涵蓋範圍 Narwhal API 涵蓋範圍 (narwhalapi.com)](https://narwhalapi.com/coverage.md)
- [價格 Calendarific 方案價格 (calendarific.com)](https://calendarific.com/pricing)
- [Calendarific API 文件 (calendarific.com)](https://calendarific.com/api-documentation)
- [Calendarific 支援的國家 (calendarific.com)](https://calendarific.com/supported-countries)
- [價格 HolidayAPI 方案價格 (holidayapi.com)](https://holidayapi.com/pricing)
- [文件 HolidayAPI 文件 (holidayapi.com)](https://holidayapi.com/docs)
- [GitHub 上的 Nager.Date (github.com)](https://github.com/nager/Nager.Date)
- [Nager.Date 服務條款 (nagerholidays.com)](https://nagerholidays.com/legal/termsofservice)
- [Nager.Date 國家涵蓋範圍 (nagerholidays.com)](https://nagerholidays.com/country/coverage)
- [API Nager.Date API (nagerholidays.com)](https://nagerholidays.com/api)
- [API Abstract 假日 API (abstractapi.com)](https://www.abstractapi.com/api/holidays-api)
- [API Abstract 假日 API 文件 (docs.abstractapi.com)](https://docs.abstractapi.com/api/holidays)
- [GitHub 上的 date-holidays (github.com)](https://github.com/commenthol/date-holidays)
- [npm 上的 date-holidays (registry.npmjs.org)](https://registry.npmjs.org/date-holidays)
- [Federal Reserve Financial Services 休息日時程 (frbservices.org)](https://www.frbservices.org/about/holiday-schedules)

## 比較

- [免費假日 API：7款比較（含 Python）](https://narwhalapi.com/zh-tw/compare/holiday-apis.md)
- [HolidayAPI 替代與 Calendarific 替代方案：假日 API](https://narwhalapi.com/zh-tw/compare/holidayapi-alternatives.md)
- [Calendarific vs HolidayAPI](https://narwhalapi.com/zh-tw/compare/calendarific-vs-holidayapi.md)
- [外匯 API 免費與付費：8個比較](https://narwhalapi.com/zh-tw/compare/fx-apis.md)
- [經濟數據 API 比較](https://narwhalapi.com/zh-tw/compare/economic-data-apis.md)
- [所有比較](https://narwhalapi.com/zh-tw/compare.md)

## 從免費金鑰開始

每月 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。

[取得免費 API 金鑰](https://narwhalapi.com/zh-tw/signup)
