使用需知

提莫的神秘商店提供 http://timor.tech/api/holiday
获取指定日期的节假日信息

接口地址: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), // 节假日类型,分别表示 工作日、周末、节日。"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
@params $date: 指定日期的字符串,多个日期之间用逗号,隔开。格式 ‘2018-02-23’。
@return json: 返回以日期为key的对象。

{"code": 0,               // 0服务正常。-1服务出错"holiday": {             // 传过来的日期是什么,key就是什么。传多少个就有多少个。"2017-10-01": {        // holiday的值都是一致的"holiday": true,"name": "国庆节","wage": 2},"2017-9-12": null      // 如果不是节假日,则为null}}

示例:
http://timor.tech/api/holiday/batch?d=2018-3-1
http://timor.tech/api/holiday/batch?d=2017-10-01,2018-6-01,2018-10-1

获取指定日期的下一个节假日(如果在放假前有调休,也会返回)

接口地址: http://timor.tech/api/holiday/next/$date
@params $data: 指定日期的字符串,格式 ‘2018-02-23’。可以省略,则默认服务器的当前时间。
@return json: 返回指定日期的下一个最近的节假日,如果在放假之前要调休,则会一起返回调休的信息。

{"code": 0,              // 0服务正常。-1服务出错"holiday": {"holiday": true,      // 该字段一定为true"name": "国庆节",      // 节假日的中文名。"wage": 3,            // 薪资倍数,3表示是3倍工资"date": "2018-10-01"  // 节假日的日期},"workday": {             // 如果节假日前没调休,则此字段为null"holiday": false,      // 此字段一定为false"name": "国庆前调休",   // 调休的中文名"wage": 1,            // 薪资倍数,3表示是3倍工资"after": false,       // true表示放完假后调休,false表示先调休再放假"target": '国庆节',    // 表示调休的节假日"date": "2018-09-29"  // 表示要调休的日期}}

示例:
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/year/$date?
@params $data: 指定年份或年月份,格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’。可以省略,则默认服务器当前时间的年份。
@return json: 返回指定年份或年月份的所有节假日,以日期作为key,格式:mm-dd。如果没有该年份或月份,则返回空对象。注意目前只配置了最多比当前时间往后一年的节假日。

{"code": 0,               // 0服务正常。-1服务出错"holiday": {"10-01": {"holiday": true,     // 该字段一定为true"name": "国庆节",     // 节假日的中文名。"wage": 3,           // 薪资倍数,3表示是3倍工资"date": "2018-10-01" // 节假日的日期},"10-02": {"holiday": true,     // 该字段一定为true"name": "国庆节",     // 节假日的中文名。"wage": 3,           // 薪资倍数,3表示是3倍工资"date": "2018-10-01" // 节假日的日期}}}

示例:
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: 返回可直接播放的文字。

{"code": 0,       // 0服务正常。-1服务出错"tts": "明天就是周六了,今天努力工作哦!。最近的一个节日是清明节。还要12天。早着呢!"}

示例语句:
今天是周末,放松一下吧!
今天是国庆节前调休,明天就是国庆节了,加油!
你在想什么!今天就是国庆节啊。
清明节才刚刚过完,今天是清明节调休,老老实实上班吧。
很遗憾的告诉您,这周六要劳动节前调休,不过周日就是劳动节了。
很遗憾的告诉您,这周六和周日都要国庆节前调休。再过3天是国庆节。
明天就是中秋节了,开不开心?不过记得周日要中秋节调休,设置好闹钟,别玩太嗨。
明天就是周六了,今天努力工作哦!最近的一个节日是清明节。还要12天。早着呢!
还有很多情况的就不一一例举了,目前大概有2/3十种不同的表达。总之,我会尽可能的用人类友好的表达方式。


返回文字。距离今天最近的一个节假日安排。只考虑节假日和调休。

接口地址: http://timor.tech/api/holiday/tts/next
@params: 没有参数
@return json: 返回可直接播放的文字。

{"code": 0,        // 0服务正常。-1服务出错"tts": "最近的一个节日是2018-04-05的清明节,还有11天。"
}

示例语句:
今年的所有节假日都过完了,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: 返回可直接播放的文字。

{"code": 0,        // 0服务正常。-1服务出错"tts": "明天是周一,今晚早点睡,上班别迟到了。"}

示例语句:
明天是劳动节,趁着假期放松一下吧。
清明节才刚过完,明天都要清明节调休了,还想着放假呢!
明天是周六,放心睡吧。
今天才周二呢,先好好上班吧。
明天不放假,明天是劳动节前调休,马上就是劳动节了,开心吧!


浏览器端使用 ajax 请求节假日服务示例代码
// 注意:dataType: json 就行了,别写成 jsonp 了// 使用 jQuery,其它库请查看api$.ajax({type: 'get',url: 'http://timor.tech/api/holiday/tts',dataType: 'json',success: function (data) {console.log('success', data)},error: function (xhr, textstatus, error) {console.log('error', textstatus, error)}})

查看详情 提莫的神秘商店

免费好用的节假日API相关推荐

  1. 免费好用的节假日API——Java实现

    前段日子项目中需要使用的国家规定的节假日,而且还 ** 是内网,例如说: 每日xxx: 周末xxx: 工作日xxx: 每隔多少天xxx,连续持续多少天xxx(周一周二停.周三到周日xxx.可以设置为, ...

  2. 免费节假日API 更新新功能了 新增农历信息返回

    感谢大家对免费节假日API的支持.最近看了别家的api于是增加了一些新功能即获取日期的农历信息. 这个新功能还处于测试阶段如有问题欢迎反馈 检查一个日期是详细信息 https://tool.bitef ...

  3. 根据国务院2019年劳动节假期安排五一放假四天 免费节假日api第一时间调整

    根据国务院发布http://www.gov.cn/zhengce/content/2019-03/22/content_5375877.htm 以下为原文 国务院办公厅关于调整 2019年劳动节假期安 ...

  4. 大数据基础数据之中国法定节假日API

    中国法定节假日API Date: November 16, 2021 1.背景 目前业务需求中,需要分析法定节假日.我们日常查看法定节假日,都是在百度或者某些日历中查看.但是,网上很少有通过API获得 ...

  5. android节日接口,节假日api及其整合

    节假日api 今天项目中有一个需求需要用到节假日,项目需求是 要有调休日 要有周末 于是就去网上找. 看到比较合适的大概就这几个: 1.http://tool.bitefu.net/jiari?d=2 ...

  6. 工作日计算器提供节假日api

    介绍 节假日api核心服务托管在阿里云与腾讯云之上,API天然分布式.高可用. 起步 如果您需要知道某个日期N个工作日之后是什么日子,您可以使用 GET 或者 POST 向下面的入口发起一个请求. h ...

  7. 免费获取节假日API地址

    地址:免费节假日接口文档 感谢此作者给我们带来的便利. 具体用法请参考api地址中的接口文档操作即可. 目前我正在使用的地址是 http://timor.tech/api/holiday/year 获 ...

  8. 最简单判断工作日/节假日API

    由于开发的系统需要根据工作日和节假日来进行逻辑判断,所以这里研究了下方案: 1. 自己维护一份日历表,把每天的日期类型标注清楚 之前的一家公司就是这样解决的,需要每年去手动更新.如果公司规模比较大,对 ...

  9. 新增免费根据商品条码查询商品名称API

    开发十年,就只剩下这套架构体系了! >>>    免费API 可根据商品条码查询商品名称 本人把搜集成的一些网上公开的一些条码数据导入到一个数据库中,做了本api供大家免费调用. h ...

  10. 分享一个开源免费、目前最好的API接口管理平台----eoLinker

    一.概况 eoLinker 是目前业内领先.国内最大的在线 API 接口管理平台,提供自动生成 API 文档.API 自动化测试.Mock 测试.团队协作等功能,旨在解决由于前后端分离导致的开发效率低 ...

最新文章

  1. roslyn生成html,Visual Studio 2017 bin \ roslyn文件在生成期间被锁定
  2. python中调用多进程加速处理文件
  3. filco蓝牙不好用_800元和300元的机械键盘差多少,Filco圣手104晒单
  4. 什么是编译器,什么是集成开发环境?一文讲明白
  5. elementui 进度条怎么做_小E,Excel中这样的进度条是怎么做出来的?
  6. 能利用计算机来模拟某种真实的实验现象,自然现象或社会现象的课件是,《计算机辅助教学》课程复习资料...
  7. c语言计算n天之后为星期几,计算任何一天是星期几的C语言源代码.
  8. 线上四台机器同一时间全部 OOM,到底发生了什么?
  9. Python基础教程:(小窍门)如何优化Python占用的内存
  10. PyCharm修改主题和修改背景
  11. 芒果DB:mongodb
  12. 计算机基础知识200分选择题,计算机基础考试题库及答案
  13. 移动端浏览器识别PHP,PHP判断访客是否移动端浏览器访问
  14. html 怎么转换,html格式怎么转换
  15. 用Scipy中的linprog解决股票融资中的线性规划问题
  16. 第十届蓝桥杯大赛软件类省赛 Java 大学 B组 试题H:人物相关性分析
  17. PTA 校选拔 7-10 宇航员的寻宝图(BFS)
  18. LINQ Group Query
  19. NXP-MPC5748G车载MCU使用(食用)方法(踩坑)实用指南(骗人教程)(二):使用FREERTOS点亮LED
  20. arch 服务器系统,arch linux服务器

热门文章

  1. 背离意味着趋势正在减弱
  2. 阿里云iot事业部一面面经
  3. html注册页面带验证码,登陆注册-带图片的验证码
  4. Windows 配置 Aria2教程
  5. 《学会提问》之一——学会提出好问题
  6. matlab中figure的基本用法
  7. wps怎样删除空白页 WPS文档的空白页如何删除
  8. 固态硬盘能不能提高计算机速度,固态硬盘掉速如何解决?几招轻松提升SSD速度方法 (全文)...
  9. macos复制粘贴快捷键 快速_苹果电脑复制粘贴快捷键是什么 如何操作【图文】...
  10. poj2387(Dijkstra)