介绍

提供 HTTP 服务（Go）查询当前或指定日期是否为假日，返回中区分了假日、工作日。可以用于在特定日期类型完成自动化，比如使用 iOS 的快捷指令自动记录基金定投等。

提供脚本（Python）自动从 中国政府官网 生成调休、补班数据。生成假期 JSON 文件 提供了其他生成方式可供参考。

可以自行从 Releases 下载可执行文件并部署，或直接访问 https://holiday.dreace.top 查询假日。

目前可以查询 2023 至 2024 年的假期数据。

启动参数

短参数名	长参数名	类型	必填	说明	示例
--host	-h	string	否	监听地址，默认为 127.0.0.1	0.0.0.0
--port	-p	int	否	监听端口，默认为 80	8081

HTTP 接口参数

请求参数

参数名	类型	必填	说明	示例
date	string	否	要查询的日期，如果不填则查询当天	2023-01-02

响应参数

参数名	类型	说明	示例
date	string	查询的日期	2023-01-02
isHoliday	bool	查询的日期是否为假期	false
type	string	查询的日期类型，可能为： 假日 工作日	假日
note	string	对日期的详细描述，当 type 为 假日 时可能为： 周末 <假日描述>（非固定，可能是 元旦节 等） 当 type 为工作日时，可能为： 普通工作日 补班工作日	普通工作日

例子

访问 https://holiday.dreace.top 可以获取当天是否为假期，可能的返回：

{
  "date": "2022-12-25",
  "isHoliday": true,
  "note": "周末",
  "type": "假日"
}

如果需要在基金可交易日进行自动记账，判断 note 是否为 普通工作日 即可（补班日基金不可交易）。

可以通过 date 参数指定要查询的日期，例如 https://holiday.dreace.top?date=2023-01-02 将返回：

{
  "date": "2023-01-02",
  "isHoliday": true,
  "note": "元旦",
  "type": "假日"
}

生成假期 JSON 文件

要生成假期数据文件需要从官网复制带有标题的完整通知，如 国务院办公厅关于2024年部分节假日安排的通知。

使用 Python 脚本生成

复制通知全文粘贴到 export_holiday.py 中执行即可。

使用大语言模型（LLM）生成

可以使用 GPT-4 等大语言模型输入通知全文和参考格式快速生成假期数据，参考提示词（prompt）如下：

步骤一：请分析下面使用 ``` 包裹的 2024 年放假数据
```
<通知全文>
```
步骤二：分析下面的使用 ``` 包裹的 2023 年已生成数据作为格式参考：
```
<参考数据，可以从直接粘贴往年的 JSON 文件内容>
```
生成要求如下：
1. 日期需要按升序排序
2. 严格按照参考格式生成

生成后请务必核对生成的数据是否准确，上面的提示词仅在 GPT-4 中经过测试可以生成准确的假期数据文件。

支持功能及未来计划

• 脚本自动生成调休和补班 JSON 数据
• 提供 HTTP 服务
• 支持查询历史年份假期
• 从命令行更新服务和优雅重启