判断指定日期是否为节假日
接口概述
本接口用于判断指定日期是否为节假日。
基本信息
- 接口URL:
/v1/is_holiday
- 请求方式: GET
- 接口描述: 判断指定日期是否为节假日
请求参数
参数名 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
date | string | 是 | 需要查询的日期,格式见下方支持的格式列表 |
响应参数
参数名 | 类型 | 说明 |
---|---|---|
is_holiday | boolean | true : 是节假日;false : 不是节假日 |
holiday | string | 节假日的名称(仅当 is_holiday 为 true 时返回) |
date | string | 查询的日期 |
请求示例
GET /v1/is_holiday?date=2024-03-15
curl -X GET "https://api.jiejiariapi.com/v1/is_holiday?date=2025-01-01"
成功响应
如果日期是节假日
{
"is_holiday": true,
"holiday": "春节",
"date": "2024-02-10"
}
如果日期不是节假日:
{
"is_holiday": false,
"date": "2024-03-15"
}
其中 holiday
的数据类型与 获取年度节假日详情 结构保持一致。
失败响应
如果日期格式错误:
{
"message": "不支持的日期格式,请查看 supported_formats 列表。",
"supported_formats": [
"2006-01-02 15:04:05",
"2006-01-02 15:04",
"2006-01-02 15",
"2006-01-02"
...
]
}
支持的日期格式
以下日期格式是接口支持的输入格式:
格式示例 | 说明 |
---|---|
2006-01-02 15:04:05 |
年-月-日 时:分:秒 |
2006-01-02 15:04 |
年-月-日 时:分 |
2006-01-02 15 |
年-月-日 时 |
2006-01-02 |
年-月-日 |
2006年01月02日 15时04分05秒 |
年月日时分秒(中文格式) |
2006年01月02日 15时04分 |
年月日时分(中文格式) |
2006年01月02日 15时 |
年月日时(中文格式) |
2006年01月02日 |
年月日(中文格式) |
02/01/2006 |
日/月/年 |
02/01/2006 15:04:05 |
日/月/年 时:分:秒 |
02/01/2006 15:04 |
日/月/年 时:分 |
02/01/2006 15 |
日/月/年 时 |
关于
https://jiejiariapi.com
🇨🇳中国节假日 API
免费的节假日接口 / 周六周日接口 / 工作日接口