日历方法和覆盖范围
已发布的官方数据和文档说明来源、范围、期间与限制。
公共假日，不保证停业
日历 API 可用于下面已发布的国家-年份。事件使用当地民事日期。它们不决定银行营业时间、交易所交易时段、结算日期或特定雇主是否停业。
该 scope 该字段区分全国假日、地区假日、银行假日、政府日历和集体休假。 nationwide 它描述的是地理范围，而不是每个雇主或行业是否遵守该事件。如果来源未作说明，observed/substitute状态可以为null。
已发布的官方数据和文档说明来源、范围、期间与限制。
| 国家 | 2026 | 2027 | 已发布的官方数据和文档说明来源、范围、期间与限制。 |
|---|---|---|---|
ARG | 尚不可用 | 尚不可用 | 来源审查进行中 |
AUS | 可用 | 可用 | 仅限新南威尔士州：区域公共假日和银行假日 |
BRA | 尚不可用 | 尚不可用 | 来源审查进行中 |
CAN | 尚不可用 | 尚不可用 | 来源审查进行中 |
CHN | 可用 | 尚不可用 | 国家假日休息日；不包括补班工作日 |
FRA | 可用 | 可用 | 常见的全国法定假日；不包括地区性增加的假日 |
DEU | 尚不可用 | 尚不可用 | 来源审查进行中 |
IND | 尚不可用 | 尚不可用 | 来源审查进行中 |
IDN | 可用 | 尚不可用 | 全国假日和集体休假分别标注 |
ITA | 尚不可用 | 尚不可用 | 来源审查进行中 |
JPN | 可用 | 可用 | 全国公共假日 |
MEX | 尚不可用 | 尚不可用 | 来源审查进行中 |
KOR | 尚不可用 | 尚不可用 | 来源审查进行中 |
RUS | 尚不可用 | 尚不可用 | 来源审查进行中 |
SAU | 尚不可用 | 尚不可用 | 来源审查进行中 |
ZAF | 尚不可用 | 可用 | 全国公共假日；不包括仅限学校的假日 |
TUR | 尚不可用 | 尚不可用 | 来源审查进行中 |
GBR | 可用 | 可用 | 英格兰和威尔士、苏格兰及北爱尔兰的银行假日 |
USA | 可用 | 可用 | 联邦雇员假日及补休日；不包括州假日 |
目标仍为十九个国家。澳大利亚目前仅覆盖新南威尔士；法国不含额外地区性节假日；美国日历覆盖联邦雇员；英国银行假日保留已发布的三个地区划分；中国不含补班日，印度尼西亚将国定假日与集体休假分开。
1900–2200 的输入范围是验证边界，而不是历史覆盖范围。不可用年份不能解释为没有假日的年份。
官方来源和署名
已发布日历使用经过审核的官方文档和事实日期表。每次发布都绑定到经过审核的来源抓取、复用证据和声明作用域。来源获批不代表覆盖每个年份或地区。
- AUS: 新南威尔士州政府 · 知识共享署名 4.0.
- CHN: 国务院官方公告.
- FRA: Etalab / calendrier.api.gouv.fr · 开放许可证 2.0.
- GBR: GOV.UK Bank Holidays API · 开放 Government Licence v3.0.
- IDN: 印度尼西亚三部长法令·事实日期.
- JPN: 日本内阁府·公共数据许可 v1.0.
- USA: 美国人事管理局·事实政府日程.
- ZAF: 《南非政府公报》52178 · 官方公告.
来源发生变化时，必须先审核，才能发布替换日期。此处保留必需的来源致谢；提供方页面布局和插图不属于 API 数据。
更新与缺失覆盖
每日来源检查会查找变化。检查成功本身不能证明出现了新日期。刷新失败会保留之前获批准的发布；批准被撤销后，该发布将不会被提供。
缺失或撤回的覆盖范围返回 503 calendar_coverage_unavailable。日期端点只会在已发布的年份内返回无匹配结果。下一个假日端点先搜索请求的年份，仅在必要时才搜索下一年。它绝不会猜测尚未发布的日期。