Holiday Source
节假日数据来源说明
本页面用于说明 假日地点闹钟 当前版本在中国节假日与调班工作日判断中使用的数据来源。
1. 当前在线数据来源
当前版本使用的在线节假日数据来源为公开接口:
- 来源名称:AILCC
- 接口地址模板:https://holiday.ailcc.com/api/holiday/allyear/{year}
App 会在需要时按年份请求该接口,并将返回结果转换为本地可用的“工作日 / 节假日”状态数据。
2. 本地内置数据
为提升首次使用体验并降低接口临时不可用时的影响,App 当前还内置了以下年份的种子数据:
- 2026
- 2027
这些内置种子数据在应用内部标记为 AILCC seed。
3. 使用逻辑
- 先查本地是否已有该年份缓存
- 如果没有缓存,则尝试读取 App 内置种子数据
- 如果该年份没有内置种子,或用户主动刷新,则请求在线公开接口
- 下载成功后写入本地缓存,后续规则判断优先使用本地缓存
4. 对规则判断的影响
工作日规则依赖这份数据完成以下判断:
- 当天是否属于工作日
- 周末是否因调班而属于工作日
- 某个周六是否属于法定节假日
若上游数据发生变化,App 中工作日规则的判断结果也可能随之调整。