跳到主要内容

数据范围与可信度

权威来源​

全国统一节假日数据以国务院及国务院办公厅正式发布的年度安排为权威来源。数据集经过校验、版本化导入和发布，响应中的 datasetVersion 标识实际使用的版本。

支持范围​

  • 最早支持日期：2008-01-01；
  • 已发布年度：返回官方安排、周末和普通工作日的确定结论；
  • 未发布年度：返回 UNKNOWN，不推测调休、补班或下一节假日；
  • 已发布范围内的数据无法读取：返回 503 CALENDAR_DATA_UNAVAILABLE，不降级成 UNKNOWN。

日期状态​

数据集只保存官方安排日期。查询时按以下顺序判定：官方 HOLIDAY 或 ADJUSTED_WORKDAY 优先；未记录的周六、周日为 WEEKEND；其他日期为 WORKDAY；年度未发布时为 UNKNOWN。

调休上班日属于 ADJUSTED_WORKDAY，在工作日统计中计为工作日。连续休假区间内的周末仍按官方数据表达，不能仅根据日期推测节日归属。