Platform Holiday
Holiday 已迁移到 FreeKit.Platform，代码位于 src/Services/Platform/FreeKit.Platform/Holiday。默认主宿主启用 PlatformModuleStartup 后即可使用，不再单独注册 HolidayModuleStartup。
功能范围
- 中国节假日数据同步
- 公历、农历日期信息
- 法定节假日、调休、休假标识
- 工作日与周末识别
- 节日中文描述
数据模型
Holiday
| 字段名 | 类型 | 描述 |
|---|---|---|
| year / month / date | int | 公历年、月、日 |
| yearweek / yearday | int | 年周次、年内天数 |
| lunar_year / lunar_month / lunar_date | int | 农历年、月、日 |
| lunar_yearday | int | 农历年内天数 |
| week / weekend / workday | int | 周次、星期、工作日标识 |
| holiday | int | 节假日标识 |
| holiday_or | int | 其他节假日 |
| holiday_overtime | int | 调休标识 |
| holiday_today | int | 是否节日当天 |
| holiday_legal | int | 是否法定节假日 |
| holiday_recess | int | 是否休假日 |
| date_cn | string | 公历中文日期 |
| lunar_date_cn | string | 农历中文日期 |
| holiday_cn | string | 节假日中文名 |
API
HolidayController 仍保留历史 api/v1/Holiday 路由，Swagger 分组随 Platform 模块一起装载。
| 场景 | 方法 |
|---|---|
| 同步节假日数据 | SyncHoliday(int beginYear, int endYear) |
| 同步枚举数据 | SyncEnum() |
| 查询节假日数据 | 以 HolidayController 当前实现为准 |
配置
PlatformModuleStartup 绑定 HolidayAppOption：
{
"HolidayAppOption": {
"BeginYear": 2024,
"EndYear": 2026,
"ApiKey": "your_api_key"
}
}
| 字段 | 说明 |
|---|---|
| BeginYear | 默认同步开始年份 |
| EndYear | 默认同步结束年份 |
| ApiKey | api.apihubs.cn API Key |
数据来源
节假日数据通过 api.apihubs.cn 获取，需要配置可用 API Key。