日曆方法和覆蓋範圍
已發布的官方數據和文件說明來源、範圍、期間與限制。
公共假日，不保證停業
日曆 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。日期端點只會在已發布的年份內返回無匹配結果。下一個假日端點先搜尋請求的年份，僅在必要時才搜尋下一年。它絕不會猜測尚未發布的日期。