DexBase

Nager.Date

使用 Nager.Date 按国家和年份查询节假日,区分全国或地区适用范围,并将结果作为整理日历的起点。

当前公开响应

从 Nager.Date 加载响应,无需输入搜索词。

响应包含的内容

使用 Nager.Date 按国家和年份查询节假日,区分全国或地区适用范围,并将结果作为整理日历的起点。

列为全国节假日也不一定能说明某个城市的银行、学校、商店、配送或公共机构营业时间。发布截止日期、休假、付款或服务时间前,请核对 subdivisionCodes、holidayTypes 以及主管机构的官方信息。

值得查看的字段

  • ISO 格式日期
  • 节假日名称
  • 全国或地区适用范围
  • 节假日类型

年度查询返回什么

Holidays 路径将国家和年份放在路径中。对于 BR 与 2026,已观察到的响应是一组对象。每个对象包含 YYYY-MM-DD 格式的 date、name、countryCode、nationalHoliday、subdivisionCodes 和 holidayTypes。并非每个节假日都适用于全国,因此在将某天标为所有人不可用前,应先阅读适用范围。

  • countryCode 是所查询的国家代码,不表示城市。
  • 请同时阅读 nationalHoliday 与 subdivisionCodes;某个日期可能仅适用于一个地区。
  • holidayTypes 是服务分类,不代表当地营业时间已经得到确认。

如何准备有效请求

先选择两位 ISO 国家代码,再选择要规划的年份。此页以 BR 和 2026 为例,因为年度响应能在同一列表中比较字段。制作团队日历时,请将日期与适用范围分开保存,不要把每项都当作全国休假日。

  • 在 URL 中保留明确年份,以免混合不同期间的日历。
  • 在其他项目复用响应前,先确认国家代码是否正确。
  • 仅排序并突出显示与所需地点或规则相符的日期。

用于截止日期前的注意事项

节假日列表有助于规划,但不能单独决定服务、银行清算、配送、课程或法律义务是否照常进行。适用范围可能随城市、机构和活动而变化。如果日期影响资金、合同、公共期限或旅行,请向主管机构、公司或服务确认规则。

  • 未检查返回字段前,不要把地区日期说成全国停业。
  • 不要仅凭 API 计算法定期限。
  • 当决定取决于具体时间或义务时,请记录所核对的官方来源。
BrasilAPI Feriados 日期 · 节假日名称 · 类型 · 星期 Nager.Date Holidays 的真实预览 Nager.Date Holidays 日期 · 本地名称 · 适用范围 · 节假日类型 BrasilAPI Bancos ispb:机构标识 · name:简称 · code:可用时的银行代码 · fullName:完整名称