查询单个日期
接口信息
- 接口地址:
/date/:date - 请求方式:
GET - 内容类型:
application/json
路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| date | string | 是 | 日期,支持多种格式:YYYY-MM-DD(推荐)、YYYY/MM/DD、YYYYMMDD、DD/MM/YYYY、MM-DD-YYYY、MM/DD/YYYY、MMDDYYYY |
请求示例
curl -X GET https://api.apisbo.com/holidays/date/2025-01-01
curl -X GET https://api.apisbo.com/holidays/date/2025/01/01
curl -X GET https://api.apisbo.com/holidays/date/20250101响应示例
节假日响应
{
"code": 0,
"msg": "success",
"data": {
"date": "2025-01-01",
"isHoliday": true,
"isWorkday": false,
"holiday": {
"date": "2025-01-01",
"name": "元旦",
"type": "holiday"
},
"dayOfWeek": 3
}
}工作日响应
{
"code": 0,
"msg": "success",
"data": {
"date": "2025-01-06",
"isHoliday": false,
"isWorkday": true,
"holiday": null,
"dayOfWeek": 1
}
}周末响应
{
"code": 0,
"msg": "success",
"data": {
"date": "2025-01-11",
"isHoliday": true,
"isWorkday": false,
"holiday": null,
"dayOfWeek": 6
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| data.date | string | 查询的日期 |
| data.isHoliday | boolean | 是否为节假日(包括周末) |
| data.isWorkday | boolean | 是否为工作日 |
| data.holiday | object/null | 节假日信息,无特殊节假日时为 null |
| data.holiday.date | string | 节假日日期 |
| data.holiday.name | string | 节假日名称 |
| data.holiday.type | string | 类型:holiday(节假日)/ workday(调休工作日) |
| data.dayOfWeek | number | 星期几(0-6,0 表示周日) |
注意事项
- 推荐使用
YYYY-MM-DD格式,但也支持其他常见日期格式 - 如果查询的日期不在节假日数据中,则根据周末判断是否为节假日
- 所有日期格式都会在内部统一转换为
YYYY-MM-DD标准格式进行处理
最后更新于