
每到节假日前夕,总会有不少人或者公司遇到同一个问题:
那么,有没有更简单的方法维护一套准确、完整的节假日数据? 答案当然是有的!!
如果你的系统需要展示全年节假日,那么节假日列表接口就非常实用。 通过接口,可以快速获取指定年份的节假日数据。 开发者无需再手动整理全年日历,也不用担心遗漏重要节日。

名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
year | String | 否 | 需要查询的年份, 默认查询当年的节假日列表 |
例如可以实现:
对于需要制作节日运营页面的平台来说,提前获取完整节假日列表,可以大幅提高开发效率。
{
"code": 200, // 详见返回码说明
"msg": "成功",
"taskNo": "526782409178028989145499", // 请求号
"charge": true, // 计费标识
"data": {
"count": 12, // 一年的节假日数量
"items": [ // 一年的节假日列表
{
"begin": "20181230", // 节假日的开始时间
"end": "20190101", // 节假日的结束时间
"holiday": "元旦", // 节假日名称
"holiday_remark": "放假3天,其中2018年12月30日至2019年1月1日放假调休,2018年12月29日(周六)正常上班", // 节假日描述
"inverse_days": [ // 调修日列表,只有2021年之后的数据有值
"20181229"
]
}
]
}
}除了获取节假日列表之外,更常用的是节假日详情查询。 只需要传入日期,即可查询当天对应的节假日信息。 不仅能够查询法定节假日,还可以获取对应的世界国际日等相关信息。
名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
date | String | 否 | 查询的日期,默认当天 |
needDesc | String | 否 | 是否需要返回当日公众日、国际日和我国传统节日的简介,1-返回,默认不返回 |
例如可以实现:
{
"code": 200, // 详见返回码说明
"msg": "成功",
"taskNo": "526782409178028989145499", // 请求号
"charge": true, // 计费标识
"data": {
"day": "20210501", // 查询的日期
"holiday": "劳动节", // 节日名称,工作日时显示“无”,周末时显示“周末”,节日时显示节日名称
"type": "3", // 1为工作日,2为周末,3为节假日
"begin": "20210501", // 节日或周末开始时间,如果是工作日,此字段为空串
"end": "20210503", // 节日或周末结束时间,如果是工作日,此字段为空串
"holiday_remark": "5月1日—5月3日放假,共3天,5月8日(星期六)要上班。", // 节日备注
"weekDay": 6, // 星期几的数字
"cn": "周六", // 英期几的中文名
"en": "Saturday", // 星期几的英文名
"h": [ // 如果当日没有节日则返回空List,该字段需要请求参数中needDesc上传1才返回
{
"name": "世界文化发展日", // 节日名称
"genus": "public", // 节日种类,public表示公众日或国际日,traditional表示传统节日
"day": "0521", // 节日公历日期
"lunaDay": "", // 节日的农历日期
"info": "", // 节日的简介
"origin": "" // 节日的起源
}
]
}
}对于需要构建日历、提醒、营销、预约、排班、旅游预订等功能的系统来说,这类接口能够有效减少数据维护成本,提高开发效率,同时也能为用户提供更加智能、更加丰富的产品体验。 相比之下,接口方式具有不少优势:
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。