免费节假日 API
转载地址:http://timor.tech/api/holiday
获取指定日期的节假日信息
接口地址:http://timor.tech/api/holiday/info/$date
@params $date: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@return json: 如果不是节假日,holiday字段为null。
1 |
{ |
示例:
http://timor.tech/api/holiday/info/2018-3-2
http://timor.tech/api/holiday/info/2018-03-02
http://timor.tech/api/holiday/info
批量查询指定日期节假日信息
接口地址:http://timor.tech/api/holiday/batch?d=$date&type=Y
@params d: 指定日期的字符串,多个日期之间使用 &
连接。最大长度查询个数50。兼容旧的格式用逗号,隔开,但不建议。格式 ‘2018-02-23’。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@return json: 返回以日期为key的对象。
1 |
{ |
示例:
http://timor.tech/api/holiday/batch?d=2018-3-1
http://timor.tech/api/holiday/batch?d=2020-01-01&d=2020-01-02
http://timor.tech/api/holiday/batch?d=2017-10-01,2018-6-01,2018-10-1
获取指定日期的下一个节假日(如果在放假前有调休,也会返回)
接口地址: http://timor.tech/api/holiday/next/$date?type=Y&week=Y
@params $date: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
@return json: 返回指定日期的下一个最近的节假日,如果在放假之前要调休,则会一起返回调休的信息。如果包含周末,则节日和周末冲突时,以节日为优先级。 比如特殊情况:周六是调休,则holiday返回周日,workday返回周六。其它情况以此类推,holiday永远会返回下一个节日。
1 |
{ |
示例:
http://timor.tech/api/holiday/next/2018-6-1
http://timor.tech/api/holiday/next/2018-09-28
http://timor.tech/api/holiday/next
获取指定日期的下一个工作日(工作日包含正常工作日、调休)不包含当天
接口地址: http://timor.tech/api/holiday/workday/next/$date
@params $data: 指定日期的字符串,格式 ‘2020-01-20’。可以省略,则默认服务器的当前时间。
@return json: 返回指定日期的下一个最近的工作日。工作日包含正常工作日、调休,不包含当天。
1 |
{ |
示例:
http://timor.tech/api/holiday/workday/next/2018-6-1
http://timor.tech/api/holiday/workday/next/2018-09-28
http://timor.tech/api/holiday/workday/next
获取指定年份或年月份的所有节假日信息。默认返回当前年份的所有信息。
接口地址: http://timor.tech/api/holiday/year/$date?type=Y&week=Y
@params $date: 指定年份或年月份,格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’。可以省略,则默认服务器当前时间的年份。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
@return json: 返回指定年份或年月份的所有节假日,以日期作为key,格式:mm-dd。如果没有该年份或月份,则返回空对象。注意目前只配置了最多比当前时间往后一年的节假日。如果包含周末,则节日和周末冲突时,以节日为准。
1 |
{ |
示例:
http://timor.tech/api/holiday/year
http://timor.tech/api/holiday/year/2018/
http://timor.tech/api/holiday/year/2019-02
下面是高级API。返回人类可阅读的文字,适用于语音交互中。
例如:使用文字转语音,把返回的结果直接播放出来。适用于VUI语音交互中使用。
返回文字。距离今天最近的一个放假安排。周六周末、调休、节假日都会考虑,比较全面的放假安排。
接口地址: http://timor.tech/api/holiday/tts
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
今天是周末,放松一下吧!
今天是国庆节前调休,明天就是国庆节了,加油!
你在想什么!今天就是国庆节啊。
清明节才刚刚过完,今天是清明节调休,老老实实上班吧。
很遗憾的告诉您,这周六要劳动节前调休,不过周日就是劳动节了。
很遗憾的告诉您,这周六和周日都要国庆节前调休。再过3天是国庆节。
明天就是中秋节了,开不开心?不过记得周日要中秋节调休,设置好闹钟,别玩太嗨。
明天就是周六了,今天努力工作哦!最近的一个节日是清明节。还要12天。早着呢!
还有很多情况的就不一一例举了,目前大概有2/3十种不同的表达。总之,我会尽可能的用人类友好的表达方式。
返回文字。距离今天最近的一个节假日安排。只考虑节假日和调休。
接口地址: http://timor.tech/api/holiday/tts/next
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
今年的所有节假日都过完了,2019年的节假日开发者还在偷懒。
最近的一个节日是2018-04-05的清明节,还有11天。
最近的一个节日是2018-04-28的劳动节,还有9天。在这之前先要劳动节前调休。
最近的一个节日是2018-04-28的劳动节,还有2天。不过记得明天先要劳动节前调休。
最近的一个节日是2018-04-28的劳动节,还有21天。明天要记得清明节调休。
最近的一个节日是2018-04-28的劳动节,还有22天。在这之前先把清明节调休完吧。
更多示例不一一例举了,会根据时间不同,调整明天,后天等的表达。
返回文字。回答明天放假吗。
接口地址: http://timor.tech/api/holiday/tts/tomorrow
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
明天是劳动节,趁着假期放松一下吧。
清明节才刚过完,明天都要清明节调休了,还想着放假呢!
明天是周六,放心睡吧。
今天才周二呢,先好好上班吧。
明天不放假,明天是劳动节前调休,马上就是劳动节了,开心吧!
浏览器端使用 ajax 请求节假日服务示例代码
1 |
// 注意:dataType: json 就行了,别写成 jsonp 了 |
获取指定日期的节假日信息
接口地址:http://timor.tech/api/holiday/info/$date
@params $date: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@return json: 如果不是节假日,holiday字段为null。
1 |
{ |
示例:
http://timor.tech/api/holiday/info/2018-3-2
http://timor.tech/api/holiday/info/2018-03-02
http://timor.tech/api/holiday/info
批量查询指定日期节假日信息
接口地址:http://timor.tech/api/holiday/batch?d=$date&type=Y
@params d: 指定日期的字符串,多个日期之间使用 &
连接。最大长度查询个数50。兼容旧的格式用逗号,隔开,但不建议。格式 ‘2018-02-23’。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@return json: 返回以日期为key的对象。
1 |
{ |
示例:
http://timor.tech/api/holiday/batch?d=2018-3-1
http://timor.tech/api/holiday/batch?d=2020-01-01&d=2020-01-02
http://timor.tech/api/holiday/batch?d=2017-10-01,2018-6-01,2018-10-1
获取指定日期的下一个节假日(如果在放假前有调休,也会返回)
接口地址: http://timor.tech/api/holiday/next/$date?type=Y&week=Y
@params $date: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
@return json: 返回指定日期的下一个最近的节假日,如果在放假之前要调休,则会一起返回调休的信息。如果包含周末,则节日和周末冲突时,以节日为优先级。 比如特殊情况:周六是调休,则holiday返回周日,workday返回周六。其它情况以此类推,holiday永远会返回下一个节日。
1 |
{ |
示例:
http://timor.tech/api/holiday/next/2018-6-1
http://timor.tech/api/holiday/next/2018-09-28
http://timor.tech/api/holiday/next
获取指定日期的下一个工作日(工作日包含正常工作日、调休)不包含当天
接口地址: http://timor.tech/api/holiday/workday/next/$date
@params $data: 指定日期的字符串,格式 ‘2020-01-20’。可以省略,则默认服务器的当前时间。
@return json: 返回指定日期的下一个最近的工作日。工作日包含正常工作日、调休,不包含当天。
1 |
{ |
示例:
http://timor.tech/api/holiday/workday/next/2018-6-1
http://timor.tech/api/holiday/workday/next/2018-09-28
http://timor.tech/api/holiday/workday/next
获取指定年份或年月份的所有节假日信息。默认返回当前年份的所有信息。
接口地址: http://timor.tech/api/holiday/year/$date?type=Y&week=Y
@params $date: 指定年份或年月份,格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’。可以省略,则默认服务器当前时间的年份。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
@return json: 返回指定年份或年月份的所有节假日,以日期作为key,格式:mm-dd。如果没有该年份或月份,则返回空对象。注意目前只配置了最多比当前时间往后一年的节假日。如果包含周末,则节日和周末冲突时,以节日为准。
1 |
{ |
示例:
http://timor.tech/api/holiday/year
http://timor.tech/api/holiday/year/2018/
http://timor.tech/api/holiday/year/2019-02
下面是高级API。返回人类可阅读的文字,适用于语音交互中。
例如:使用文字转语音,把返回的结果直接播放出来。适用于VUI语音交互中使用。
返回文字。距离今天最近的一个放假安排。周六周末、调休、节假日都会考虑,比较全面的放假安排。
接口地址: http://timor.tech/api/holiday/tts
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
今天是周末,放松一下吧!
今天是国庆节前调休,明天就是国庆节了,加油!
你在想什么!今天就是国庆节啊。
清明节才刚刚过完,今天是清明节调休,老老实实上班吧。
很遗憾的告诉您,这周六要劳动节前调休,不过周日就是劳动节了。
很遗憾的告诉您,这周六和周日都要国庆节前调休。再过3天是国庆节。
明天就是中秋节了,开不开心?不过记得周日要中秋节调休,设置好闹钟,别玩太嗨。
明天就是周六了,今天努力工作哦!最近的一个节日是清明节。还要12天。早着呢!
还有很多情况的就不一一例举了,目前大概有2/3十种不同的表达。总之,我会尽可能的用人类友好的表达方式。
返回文字。距离今天最近的一个节假日安排。只考虑节假日和调休。
接口地址: http://timor.tech/api/holiday/tts/next
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
今年的所有节假日都过完了,2019年的节假日开发者还在偷懒。
最近的一个节日是2018-04-05的清明节,还有11天。
最近的一个节日是2018-04-28的劳动节,还有9天。在这之前先要劳动节前调休。
最近的一个节日是2018-04-28的劳动节,还有2天。不过记得明天先要劳动节前调休。
最近的一个节日是2018-04-28的劳动节,还有21天。明天要记得清明节调休。
最近的一个节日是2018-04-28的劳动节,还有22天。在这之前先把清明节调休完吧。
更多示例不一一例举了,会根据时间不同,调整明天,后天等的表达。
返回文字。回答明天放假吗。
接口地址: http://timor.tech/api/holiday/tts/tomorrow
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
明天是劳动节,趁着假期放松一下吧。
清明节才刚过完,明天都要清明节调休了,还想着放假呢!
明天是周六,放心睡吧。
今天才周二呢,先好好上班吧。
明天不放假,明天是劳动节前调休,马上就是劳动节了,开心吧!
浏览器端使用 ajax 请求节假日服务示例代码
1 |
// 注意:dataType: json 就行了,别写成 jsonp 了 |
------------恢复内容开始------------
获取指定日期的节假日信息
接口地址:http://timor.tech/api/holiday/info/$date
@params $date: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@return json: 如果不是节假日,holiday字段为null。
{
"code": 0, // 0服务正常。-1服务出错
"type": {
"type": enum(0, 1, 2, 3), // 节假日类型,分别表示 工作日、周末、节日、调休。
"name": "周六", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
"week": enum(1 - 7) // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
},
"holiday": {
"holiday": false, // true表示是节假日,false表示是调休
"name": "国庆前调休", // 节假日的中文名。如果是调休,则是调休的中文名,例如'国庆前调休'
"wage": 1, // 薪资倍数,1表示是1倍工资
"after": false, // 只在调休下有该字段。true表示放完假后调休,false表示先调休再放假
"target": '国庆节' // 只在调休下有该字段。表示调休的节假日
}
}
示例:
http://timor.tech/api/holiday/info/2018-3-2
http://timor.tech/api/holiday/info/2018-03-02
http://timor.tech/api/holiday/info
批量查询指定日期节假日信息
接口地址:http://timor.tech/api/holiday/batch?d=$date&type=Y
@params d: 指定日期的字符串,多个日期之间使用 &
连接。最大长度查询个数50。兼容旧的格式用逗号,隔开,但不建议。格式 ‘2018-02-23’。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@return json: 返回以日期为key的对象。
1 |
{ |
示例:
http://timor.tech/api/holiday/batch?d=2018-3-1
http://timor.tech/api/holiday/batch?d=2020-01-01&d=2020-01-02
http://timor.tech/api/holiday/batch?d=2017-10-01,2018-6-01,2018-10-1
获取指定日期的下一个节假日(如果在放假前有调休,也会返回)
接口地址: http://timor.tech/api/holiday/next/$date?type=Y&week=Y
@params $date: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
@return json: 返回指定日期的下一个最近的节假日,如果在放假之前要调休,则会一起返回调休的信息。如果包含周末,则节日和周末冲突时,以节日为优先级。 比如特殊情况:周六是调休,则holiday返回周日,workday返回周六。其它情况以此类推,holiday永远会返回下一个节日。
1 |
{ |
示例:
http://timor.tech/api/holiday/next/2018-6-1
http://timor.tech/api/holiday/next/2018-09-28
http://timor.tech/api/holiday/next
获取指定日期的下一个工作日(工作日包含正常工作日、调休)不包含当天
接口地址: http://timor.tech/api/holiday/workday/next/$date
@params $data: 指定日期的字符串,格式 ‘2020-01-20’。可以省略,则默认服务器的当前时间。
@return json: 返回指定日期的下一个最近的工作日。工作日包含正常工作日、调休,不包含当天。
1 |
{ |
示例:
http://timor.tech/api/holiday/workday/next/2018-6-1
http://timor.tech/api/holiday/workday/next/2018-09-28
http://timor.tech/api/holiday/workday/next
获取指定年份或年月份的所有节假日信息。默认返回当前年份的所有信息。
接口地址: http://timor.tech/api/holiday/year/$date?type=Y&week=Y
@params $date: 指定年份或年月份,格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’。可以省略,则默认服务器当前时间的年份。
@params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
@params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
@return json: 返回指定年份或年月份的所有节假日,以日期作为key,格式:mm-dd。如果没有该年份或月份,则返回空对象。注意目前只配置了最多比当前时间往后一年的节假日。如果包含周末,则节日和周末冲突时,以节日为准。
1 |
{ |
示例:
http://timor.tech/api/holiday/year
http://timor.tech/api/holiday/year/2018/
http://timor.tech/api/holiday/year/2019-02
下面是高级API。返回人类可阅读的文字,适用于语音交互中。
例如:使用文字转语音,把返回的结果直接播放出来。适用于VUI语音交互中使用。
返回文字。距离今天最近的一个放假安排。周六周末、调休、节假日都会考虑,比较全面的放假安排。
接口地址: http://timor.tech/api/holiday/tts
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
今天是周末,放松一下吧!
今天是国庆节前调休,明天就是国庆节了,加油!
你在想什么!今天就是国庆节啊。
清明节才刚刚过完,今天是清明节调休,老老实实上班吧。
很遗憾的告诉您,这周六要劳动节前调休,不过周日就是劳动节了。
很遗憾的告诉您,这周六和周日都要国庆节前调休。再过3天是国庆节。
明天就是中秋节了,开不开心?不过记得周日要中秋节调休,设置好闹钟,别玩太嗨。
明天就是周六了,今天努力工作哦!最近的一个节日是清明节。还要12天。早着呢!
还有很多情况的就不一一例举了,目前大概有2/3十种不同的表达。总之,我会尽可能的用人类友好的表达方式。
返回文字。距离今天最近的一个节假日安排。只考虑节假日和调休。
接口地址: http://timor.tech/api/holiday/tts/next
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
今年的所有节假日都过完了,2019年的节假日开发者还在偷懒。
最近的一个节日是2018-04-05的清明节,还有11天。
最近的一个节日是2018-04-28的劳动节,还有9天。在这之前先要劳动节前调休。
最近的一个节日是2018-04-28的劳动节,还有2天。不过记得明天先要劳动节前调休。
最近的一个节日是2018-04-28的劳动节,还有21天。明天要记得清明节调休。
最近的一个节日是2018-04-28的劳动节,还有22天。在这之前先把清明节调休完吧。
更多示例不一一例举了,会根据时间不同,调整明天,后天等的表达。
返回文字。回答明天放假吗。
接口地址: http://timor.tech/api/holiday/tts/tomorrow
@params: 没有参数
@return json: 返回可直接播放的文字。
1 |
{ |
示例语句:
明天是劳动节,趁着假期放松一下吧。
清明节才刚过完,明天都要清明节调休了,还想着放假呢!
明天是周六,放心睡吧。
今天才周二呢,先好好上班吧。
明天不放假,明天是劳动节前调休,马上就是劳动节了,开心吧!
浏览器端使用 ajax 请求节假日服务示例代码
1 |
// 注意:dataType: json 就行了,别写成 jsonp 了 |
------------恢复内容结束------------
最新文章
- hdu 2077
- AAC 格式分析
- CSS jQuery HTML5 CSS3
- bzoj 1040: [ZJOI2008]骑士 環套樹DP
- C# WPF 建立无边框(标题栏)的登录窗口
- Scraping JavaScript webpages with webkit | WebScraping.com
- 2014最热门、最具争议的10个Java话题
- 关系型数据库 VS 非关系型数据库
- Lodop打印表格带页头页尾 自动分页每页显示头尾
- mongoDB Liunx下安装及配置
- Unix中共享信息方式
- 《使用swoole》
- LoRaWAN 1.1 网络协议规范 - 3 物理层帧格式
- 2018No-java面试知识
- 用MyEclipse JPA创建项目(二)
- Android Environment.getExternalStorageDirectory() 获取的是内部存储还是外部存储?
- emacs里面模拟vim按键操作的插件evil
- C# 读Autofac源码笔记(1)
- php http_build_query stream_context_create post请求
- [STAThread] 作用