供应商候选名单
所有数据均来自各供应商自己的页面，查阅日期为 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 之外的第二个输入，再从发薪日往回倒推。
每个详细的提供商页面都会列出使用的第一方文档、其证据范围以及审查日期。 已审核: