Business Days & Public Holidays

Public holidays for 206 countries with state-level detail, plus working-day arithmetic: count business days, add business days to a date, and find days several countries work at the same time.

原始信息汇总

数据集概述

基本信息

• API名称：Business Days & Public Holidays
• 提供者：Nick Illig
• 类别：Events
• 订阅人数：1
• 价格：提供 BASIC（免费）、PRO（$9.99/月）、ULTRA（$29.99/月）、MEGA（$99.99/月）等订阅方案

核心功能

该 API 同时提供 206个国家 的公共假日日历和 工作日计算 功能，主要回答以下类型的问题：

问题类型	对应端点
查询某国某年度的节假日	/v1/holidays
判断某日是否为工作日	/v1/business-days/check
统计一段时间内的工作日数	/v1/business-days/count
计算从某日期起若干工作日后的日期	/v1/business-days/add
找出多国共同的工作日	/v1/business-days/common
查询桥假日（拼假建议）	/v1/holidays/bridge-days
获取日历文件	/v1/calendar.ics

主要特点

1. 区域级细粒度数据：支持德国各州、美国各州、西班牙自治区、加拿大各省、印度各邦等细分区域的节假日差异。
2. 自动应用国家特定周末：如中东国家周五周六休息、印度仅周日休息、尼泊尔仅周六休息，并可通过参数 weekend=fri,sat 等方式覆盖默认设置。
3. 支持自定义公司日历：通过 exclude 参数添加公司休息日，通过 include 参数标记加班日。
4. 补充假日类型：可选择 public（默认）、bank、school、observance 等假日类型。
5. 时间范围：覆盖 1970年至2100年。
6. 细节准确性：
   • 处理替代日（如英国圣诞节在周末时银行假日顺延至27、28日）；
   • 正确反映阿联酋自2022年1月1日起改为周六周日周末；
   • 所有日期均为纯日历日期，不使用时间戳，避免时区导致的日期偏移错误。

数据可靠性

• 所有结果均由 日历规则直接计算 得出，不依赖任何第三方上游服务，无外部限流问题。
• 响应结果可缓存 24小时。

示例

请求 GET /v1/business-days/add?country=DE&start=2026-12-22&days=5 返回：

json { "start": "2026-12-22", "days": 5, "result": "2026-12-30", "weekday": "wednesday", "skippedHolidays": [{ "date": "2026-12-25", "name": "Christmas Day" }] }

此示例展示了从2026年12月22日起加5个工作日的结果：12月30日（星期三），并跳过了12月25日的圣诞节。