节假日接口更新了,增加批量/范围按年按月查询

栏目分类:平台资讯 发布时间:2020-11-12 阅读次数:1733

天行数据节假日接口一直以来,深受各位开发者的欢迎。接口返回的数据全面具体、维度广泛。但一直以来,只支持单个日期的查询,在复杂场景下不够方便。因此,经过升级更新,现在支持了多种类型的查询方式,让大家使用起来更方便。

天行数据节假日接口可以查询本年度指定日期节假日相关信息,接口返回假日名称、类型、对应农历、是否上班、调休,假期范围、假期提示、拼假建议、及工作日信息等。通过请求参数mode还可以指定是否返回当天有关的国内外节日信息。



接口新增支持按年、按月、按日期范围和多个日期批量查询。如按年查询(type=1&date=2020)、按月查询(type=2&date=2020-10)、按日期范围查询(type=3&date=2020-11-1~2020-11-10)、按多个日期批量查询(date=2020-10-1,2020-11-12)


1,按月查询


按月查询需指定type参数为2,date如果传递的是年月如2020-11,返回从该月第一天到最后一天所有日期数组。如果带上了年月日如2020-11-10,则为返回从该日期到该月最后一天的所有日期数组。



2,按范围查询


按日期范围查询需指定type参数为3,此时date参数应该传递一个有起点和终点的日期范围,以波浪号分隔。如2020-11-02~2020-11-20,此时接口会返回从起点日期到终点日期所有日期数组。


3,批量查询


批量查询日期信息时,date参数传递可以任意组合两个或多个日期,如2020-10-20,2020-11-12。此时接口会返回包含这两个时间的日期数组。



请注意,按年查询只返回中国官方节假日信息;按月查询如未指定日期,就是默认为从该月第一天到最后一天;按范围查询,起点和终点用波浪号~分隔;按多个日期批量查询则用英文逗号分隔。无论哪种查询方式,包含的总日期数不能超过31天。


返回字段daycode表示日期类型,为0表示工作日、为1节假日、为2双休日、为3调休日(上班),字段isnotwork表示是否需要上班,为0表示上班,为1表示休息。(数据来自国务院办公厅假日通知)



接口文档地址:https://www.tianapi.com/apiview/139



其他推荐OTHER API 更多>

开通会员专享福利
联系客服