---
title: "工作日 API：7个对比与算法 | Narwhal API"
description: "有没有工作日 API？用公共假期列表从工作日中扣除。比较7个假期来源，附 Python 计算函数，适用于薪资与请假。"
url: "https://narwhalapi.com/zh/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/api/calendars/holidays.md)

### Calendarific

月费低廉，覆盖国家范围很广，并提供地区明细和假日类型。

[阅读详细比较](https://narwhalapi.com/zh/compare/calendarific.md)

### HolidayAPI

适合需要顺延日期、工作日计算和保存结果权利的多国薪资场景。

[阅读详细比较](https://narwhalapi.com/zh/compare/holidayapi.md)

### Nager.Date

适合原型和内部工具，只要一个无需密钥、也没有标明速率限制的免费托管 API 就够用。

[阅读详细比较](https://narwhalapi.com/zh/compare/nager-date.md)

### Abstract API

适合已在使用其他 Abstract API，并希望只用一个带地区条目的假日接口的团队。

[阅读详细比较](https://narwhalapi.com/zh/compare/abstract-api.md)

### date-holidays

适合希望在进程内使用假日规则、无配额也无网络调用的 Node.js 薪资引擎。

[阅读详细比较](https://narwhalapi.com/zh/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/compare/stock-market-holiday-apis.md)

### 伊斯兰历及浮动假日

开斋节和宰牲节的日期取决于月亮观测。Nager.Date 把 Eid al-Fitr 和 Eid al-Adha 排除在项目之外，并把基于回历的日期标为大致日期，可能偏差一两天。对于这些国家的员工，请使用遵循政府公告的来源。Narwhal 读取政府官方来源，其 MCP 工具包含回历日期转换。在向员工承诺日期之前，请逐个核对你发薪的国家。

### 发薪日与银行休业

公共假日列表无法告诉你银行何时处理你的文件。对于美国直接存款，联邦储备系统公布了含处理截止和恢复时间的 FedACH 表。假日落在周六时，联邦储备银行在前一个周五照常营业；落在周日时，则在随后的周一休业。请把这张表作为假日 API 之外的第二个输入，再从发薪日往回倒推。

[比较供应商](https://narwhalapi.com/zh/compare/stock-market-holiday-apis.md)

每个详细的提供商页面都会列出使用的第一方文档、其证据范围以及审查日期。 已审核: 2026-11-03

## 来源及审核日期

- [Calendarific 证据和来源](https://narwhalapi.com/zh/compare/calendarific.md)
- [HolidayAPI 证据和来源](https://narwhalapi.com/zh/compare/holidayapi.md)
- [Nager.Date 证据和来源](https://narwhalapi.com/zh/compare/nager-date.md)
- [Abstract API 证据和来源](https://narwhalapi.com/zh/compare/abstract-api.md)
- [date-holidays 证据和来源](https://narwhalapi.com/zh/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/compare/holiday-apis.md)
- [HolidayAPI 替代与 Calendarific 替代方案：节假日 API](https://narwhalapi.com/zh/compare/holidayapi-alternatives.md)
- [Calendarific vs HolidayAPI](https://narwhalapi.com/zh/compare/calendarific-vs-holidayapi.md)
- [外汇 API 免费与付费：8个对比](https://narwhalapi.com/zh/compare/fx-apis.md)
- [经济数据 API 比较](https://narwhalapi.com/zh/compare/economic-data-apis.md)
- [所有比较](https://narwhalapi.com/zh/compare.md)

## 从免费密钥开始

每月赠送 10 美元免费额度，无需绑卡。每月 10 美元免费额度，无需绑卡。

[获取免费 API 密钥](https://narwhalapi.com/zh/signup)
