Nager.Date Holidays

日期 · 本地名称 · 适用范围 · 节假日类型

官方文档

实时查询

输入真实查询，查看卡片结果，再打开完整来源确认更多信息。

快速示例

响应包含的内容

尝试 BR、US和JP，根据返回字段识别正确条目。

值得查看的字段

日期
本地名称
适用范围
节假日类型

国家和年份决定查询的日历

节假日请求使用国家代码，年度端点还需要年份。每个返回项包含 date、localName、name 和 countryCode。date 使用 YYYY-MM-DD 格式；localName 保留该国使用的名称，name 可能是另一种呈现。相同庆祝活动会因地点而有不同名称或日期，因此比较前请先选择国家和年份。

请使用两位国家代码，如 BR、US 或 JP。
制作国际日历时，请将 countryCode 与日期一并保留。
本地语境重要时，请显示 localName。

适用范围和类型需要谨慎解读

global、counties 和 types 有助于理解条目的适用范围。节假日可能不适用于整个国家，也可能在 counties 中标明地域限制。types 是来源中的分类，不能替代对法律、劳动合同、校历或当地主管部门通知的核实。请用它组织查询，而不要据此断言义务。

将日期视为全国适用前，请检查 counties。
请将 types 显示为来源提供的分类。
需要正式决定时，请确认相关地点或机构的日历。

未来日期应再次查询

API 提供年度列表和下一批节假日的路由。fixed 和 launchYear 会出现在部分结果的元数据中，但返回集合仍取决于请求的国家和期间。如果日程依赖未来日期，请在接近使用时再次查询，并记录数据获取时间。这样可避免把旧列表用于另一个年份或地点。

请用年度列表规划确定的时间段。
请用下一批节假日查看简短且最新的信息。
发布日历时，请记录年份、国家和查询时间。