免費節(jié)假日 API

轉(zhuǎn)載地址：http://timor.tech/api/holiday

獲取指定日期的節(jié)假日信息

接口地址：http://timor.tech/api/holiday/info/$date
@params $date: 指定日期的字符串，格式 ‘2018-02-23’?？梢允÷裕瑒t默認服務器的當前時間。
@return json: 如果不是節(jié)假日，holiday字段為null。

{　
  "code": 0,              // 0服務正常。-1服務出錯
  "type": {
    "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
    "name": "周六",         // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
    "week": enum(1 - 7)    // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
  },
  "holiday": {
    "holiday": false,     // true表示是節(jié)假日，false表示是調(diào)休
    "name": "國慶前調(diào)休",  // 節(jié)假日的中文名。如果是調(diào)休，則是調(diào)休的中文名，例如'國慶前調(diào)休'
    "wage": 1,            // 薪資倍數(shù)，1表示是1倍工資
    "after": false,       // 只在調(diào)休下有該字段。true表示放完假后調(diào)休，false表示先調(diào)休再放假
    "target": '國慶節(jié)'     // 只在調(diào)休下有該字段。表示調(diào)休的節(jié)假日
  }
}

示例：

http://timor.tech/api/holiday/info/2018-3-2
http://timor.tech/api/holiday/info/2018-03-02
http://timor.tech/api/holiday/info

批量查詢指定日期節(jié)假日信息

接口地址：http://timor.tech/api/holiday/batch?d=$date&type=Y

@params d: 指定日期的字符串，多個日期之間使用 & 連接。最大長度查詢個數(shù)50。兼容舊的格式用逗號,隔開，但不建議。格式 ‘2018-02-23’。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@return json: 返回以日期為key的對象。

{
  "code": 0,               // 0服務正常。-1服務出錯
  "holiday": {             // 傳過來的日期是什么，key就是什么。傳多少個就有多少個。
    "2017-10-01": {        // holiday的值都是一致的
      "holiday": true,
      "name": "國慶節(jié)",
      "wage": 2
    },
    "2017-9-12": null      // 如果不是節(jié)假日，則為null
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "2017-10-01": {             // 一一對應holiday對象的key，holiday有多少個這里就有多少個
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

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

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

接口地址: http://timor.tech/api/holiday/next/$date?type=Y&week=Y

@params $date: 指定日期的字符串，格式 ‘2018-02-23’。可以省略，則默認服務器的當前時間。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@params week: 節(jié)假日是否包含周末，默認不包含。可選值：’Y’ 包含周末，’N’ 不包含。
@return json: 返回指定日期的下一個最近的節(jié)假日，如果在放假之前要調(diào)休，則會一起返回調(diào)休的信息。如果包含周末，則節(jié)日和周末沖突時，以節(jié)日為優(yōu)先級。比如特殊情況：周六是調(diào)休，則holiday返回周日，workday返回周六。其它情況以此類推，holiday永遠會返回下一個節(jié)日。

{
  "code": 0,              // 0服務正常。-1服務出錯
  "holiday": {
    "holiday": true,      // 該字段一定為true
    "name": "國慶節(jié)",      // 節(jié)假日的中文名。
    "wage": 3,            // 薪資倍數(shù)，3表示是3倍工資
    "date": "2018-10-01"  // 節(jié)假日的日期
    "rest": 3             // 表示當前時間距離目標還有多少天。比如今天是 2018-09-28，距離 2018-10-01 還有3天
  },
  "workday": {             // 如果節(jié)假日前沒調(diào)休，則此字段為null
    "holiday": false,      // 此字段一定為false
    "name": "國慶前調(diào)休",   // 調(diào)休的中文名
    "wage": 1,            // 薪資倍數(shù)，3表示是3倍工資
    "after": false,       // true表示放完假后調(diào)休，false表示先調(diào)休再放假
    "target": '國慶節(jié)',    // 表示調(diào)休的節(jié)假日
    "date": "2018-09-29"  // 表示要調(diào)休的日期
    "rest": 1             // 同上。表示當前時間距離目標還有多少天。
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "holiday": {                // 對應 holiday 中的日期類型，只有返回 holiday 信息時才存在此日期類型
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    },
    "workday": {                // 對應 workday 中的日期類型，只有返回 workday 信息時才存在此日期類型
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

http://timor.tech/api/holiday/next/2018-6-1
http://timor.tech/api/holiday/next/2018-09-28
http://timor.tech/api/holiday/next

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

接口地址: http://timor.tech/api/holiday/workday/next/$date

@params $data: 指定日期的字符串，格式 ‘2020-01-20’?？梢允÷?，則默認服務器的當前時間。
@return json: 返回指定日期的下一個最近的工作日。工作日包含正常工作日、調(diào)休，不包含當天。

{
  "code": 0,                 // 0服務正常。-1服務出錯
  "workday": {               // 如果沒有查找到最近的工作日，則此字段為null。最大查找長度為30
    "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。此接口只會返回 0 和 3 的類型。
    "name": "周二",           // 工作日類型中文名，可能值為 周一 至 周五、某某調(diào)休。
    "week": enum(1 - 7)      // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    "date": "2018-09-29"     // 表示要工作的日期。
    "rest": 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

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

接口地址: http://timor.tech/api/holiday/year/$date?type=Y&week=Y

@params $date: 指定年份或年月份，格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’。可以省略，則默認服務器當前時間的年份。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@params week: 節(jié)假日是否包含周末，默認不包含。可選值：’Y’ 包含周末，’N’ 不包含。
@return json: 返回指定年份或年月份的所有節(jié)假日，以日期作為key，格式：mm-dd。如果沒有該年份或月份，則返回空對象。注意目前只配置了最多比當前時間往后一年的節(jié)假日。如果包含周末，則節(jié)日和周末沖突時，以節(jié)日為準。

{
  "code": 0,               // 0服務正常。-1服務出錯
  "holiday": {
    "10-01": {
      "holiday": true,     // 該字段一定為true
      "name": "國慶節(jié)",     // 節(jié)假日的中文名。
      "wage": 3,           // 薪資倍數(shù)，3表示是3倍工資
      "date": "2018-10-01" // 節(jié)假日的日期
    },
    "10-02": {
      "holiday": true,     // 該字段一定為true
      "name": "國慶節(jié)",     // 節(jié)假日的中文名。
      "wage": 3,           // 薪資倍數(shù)，3表示是3倍工資
      "date": "2018-10-01" // 節(jié)假日的日期
    }
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "2018-10-01": {             // 一一對應holiday對象的key，holiday有多少個這里就有多少個
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

http://timor.tech/api/holiday/year
http://timor.tech/api/holiday/year/2018/
http://timor.tech/api/holiday/year/2019-02

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

例如：使用文字轉(zhuǎn)語音，把返回的結(jié)果直接播放出來。適用于VUI語音交互中使用。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

接口地址: http://timor.tech/api/holiday/tts

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,       // 0服務正常。-1服務出錯
  "tts": "明天就是周六了，今天努力工作哦！。最近的一個節(jié)日是清明節(jié)。還要12天。早著呢！"
}

示例語句:

今天是周末，放松一下吧！
今天是國慶節(jié)前調(diào)休，明天就是國慶節(jié)了，加油！
你在想什么！今天就是國慶節(jié)啊。
清明節(jié)才剛剛過完，今天是清明節(jié)調(diào)休，老老實實上班吧。
很遺憾的告訴您，這周六要勞動節(jié)前調(diào)休，不過周日就是勞動節(jié)了。
很遺憾的告訴您，這周六和周日都要國慶節(jié)前調(diào)休。再過3天是國慶節(jié)。
明天就是中秋節(jié)了，開不開心？不過記得周日要中秋節(jié)調(diào)休，設置好鬧鐘，別玩太嗨。
明天就是周六了，今天努力工作哦！最近的一個節(jié)日是清明節(jié)。還要12天。早著呢！
還有很多情況的就不一一例舉了，目前大概有2/3十種不同的表達?？傊?，我會盡可能的用人類友好的表達方式。

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

接口地址: http://timor.tech/api/holiday/tts/next

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,        // 0服務正常。-1服務出錯
  "tts": "最近的一個節(jié)日是2018-04-05的清明節(jié)，還有11天。"
}

示例語句:

今年的所有節(jié)假日都過完了，2019年的節(jié)假日開發(fā)者還在偷懶。
最近的一個節(jié)日是2018-04-05的清明節(jié)，還有11天。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有9天。在這之前先要勞動節(jié)前調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有2天。不過記得明天先要勞動節(jié)前調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有21天。明天要記得清明節(jié)調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有22天。在這之前先把清明節(jié)調(diào)休完吧。
更多示例不一一例舉了，會根據(jù)時間不同，調(diào)整明天，后天等的表達。

返回文字?；卮鹈魈旆偶賳?。

接口地址: http://timor.tech/api/holiday/tts/tomorrow

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,        // 0服務正常。-1服務出錯
  "tts": "明天是周一，今晚早點睡，上班別遲到了。"
}

示例語句:

明天是勞動節(jié)，趁著假期放松一下吧。
清明節(jié)才剛過完，明天都要清明節(jié)調(diào)休了，還想著放假呢！
明天是周六，放心睡吧。
今天才周二呢，先好好上班吧。
明天不放假，明天是勞動節(jié)前調(diào)休，馬上就是勞動節(jié)了，開心吧！

瀏覽器端使用 ajax 請求節(jié)假日服務示例代碼

// 注意：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)
  }
})

獲取指定日期的節(jié)假日信息

接口地址：http://timor.tech/api/holiday/info/$date
@params $date: 指定日期的字符串，格式 ‘2018-02-23’。可以省略，則默認服務器的當前時間。
@return json: 如果不是節(jié)假日，holiday字段為null。

{　
  "code": 0,              // 0服務正常。-1服務出錯
  "type": {
    "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
    "name": "周六",         // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
    "week": enum(1 - 7)    // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
  },
  "holiday": {
    "holiday": false,     // true表示是節(jié)假日，false表示是調(diào)休
    "name": "國慶前調(diào)休",  // 節(jié)假日的中文名。如果是調(diào)休，則是調(diào)休的中文名，例如'國慶前調(diào)休'
    "wage": 1,            // 薪資倍數(shù)，1表示是1倍工資
    "after": false,       // 只在調(diào)休下有該字段。true表示放完假后調(diào)休，false表示先調(diào)休再放假
    "target": '國慶節(jié)'     // 只在調(diào)休下有該字段。表示調(diào)休的節(jié)假日
  }
}

示例：

http://timor.tech/api/holiday/info/2018-3-2
http://timor.tech/api/holiday/info/2018-03-02
http://timor.tech/api/holiday/info

批量查詢指定日期節(jié)假日信息

接口地址：http://timor.tech/api/holiday/batch?d=$date&type=Y

@params d: 指定日期的字符串，多個日期之間使用 & 連接。最大長度查詢個數(shù)50。兼容舊的格式用逗號,隔開，但不建議。格式 ‘2018-02-23’。
@params type: 是否返回日期類型，默認不返回。可選值：’Y’ 返回，’N’ 不返回。
@return json: 返回以日期為key的對象。

{
  "code": 0,               // 0服務正常。-1服務出錯
  "holiday": {             // 傳過來的日期是什么，key就是什么。傳多少個就有多少個。
    "2017-10-01": {        // holiday的值都是一致的
      "holiday": true,
      "name": "國慶節(jié)",
      "wage": 2
    },
    "2017-9-12": null      // 如果不是節(jié)假日，則為null
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "2017-10-01": {             // 一一對應holiday對象的key，holiday有多少個這里就有多少個
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

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

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

接口地址: http://timor.tech/api/holiday/next/$date?type=Y&week=Y

@params $date: 指定日期的字符串，格式 ‘2018-02-23’。可以省略，則默認服務器的當前時間。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@params week: 節(jié)假日是否包含周末，默認不包含?？蛇x值：’Y’ 包含周末，’N’ 不包含。
@return json: 返回指定日期的下一個最近的節(jié)假日，如果在放假之前要調(diào)休，則會一起返回調(diào)休的信息。如果包含周末，則節(jié)日和周末沖突時，以節(jié)日為優(yōu)先級。比如特殊情況：周六是調(diào)休，則holiday返回周日，workday返回周六。其它情況以此類推，holiday永遠會返回下一個節(jié)日。

{
  "code": 0,              // 0服務正常。-1服務出錯
  "holiday": {
    "holiday": true,      // 該字段一定為true
    "name": "國慶節(jié)",      // 節(jié)假日的中文名。
    "wage": 3,            // 薪資倍數(shù)，3表示是3倍工資
    "date": "2018-10-01"  // 節(jié)假日的日期
    "rest": 3             // 表示當前時間距離目標還有多少天。比如今天是 2018-09-28，距離 2018-10-01 還有3天
  },
  "workday": {             // 如果節(jié)假日前沒調(diào)休，則此字段為null
    "holiday": false,      // 此字段一定為false
    "name": "國慶前調(diào)休",   // 調(diào)休的中文名
    "wage": 1,            // 薪資倍數(shù)，3表示是3倍工資
    "after": false,       // true表示放完假后調(diào)休，false表示先調(diào)休再放假
    "target": '國慶節(jié)',    // 表示調(diào)休的節(jié)假日
    "date": "2018-09-29"  // 表示要調(diào)休的日期
    "rest": 1             // 同上。表示當前時間距離目標還有多少天。
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "holiday": {                // 對應 holiday 中的日期類型，只有返回 holiday 信息時才存在此日期類型
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    },
    "workday": {                // 對應 workday 中的日期類型，只有返回 workday 信息時才存在此日期類型
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

http://timor.tech/api/holiday/next/2018-6-1
http://timor.tech/api/holiday/next/2018-09-28
http://timor.tech/api/holiday/next

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

接口地址: http://timor.tech/api/holiday/workday/next/$date

@params $data: 指定日期的字符串，格式 ‘2020-01-20’?？梢允÷?，則默認服務器的當前時間。
@return json: 返回指定日期的下一個最近的工作日。工作日包含正常工作日、調(diào)休，不包含當天。

{
  "code": 0,                 // 0服務正常。-1服務出錯
  "workday": {               // 如果沒有查找到最近的工作日，則此字段為null。最大查找長度為30
    "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。此接口只會返回 0 和 3 的類型。
    "name": "周二",           // 工作日類型中文名，可能值為 周一 至 周五、某某調(diào)休。
    "week": enum(1 - 7)      // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    "date": "2018-09-29"     // 表示要工作的日期。
    "rest": 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

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

接口地址: http://timor.tech/api/holiday/year/$date?type=Y&week=Y

@params $date: 指定年份或年月份，格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’。可以省略，則默認服務器當前時間的年份。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@params week: 節(jié)假日是否包含周末，默認不包含?？蛇x值：’Y’ 包含周末，’N’ 不包含。
@return json: 返回指定年份或年月份的所有節(jié)假日，以日期作為key，格式：mm-dd。如果沒有該年份或月份，則返回空對象。注意目前只配置了最多比當前時間往后一年的節(jié)假日。如果包含周末，則節(jié)日和周末沖突時，以節(jié)日為準。

{
  "code": 0,               // 0服務正常。-1服務出錯
  "holiday": {
    "10-01": {
      "holiday": true,     // 該字段一定為true
      "name": "國慶節(jié)",     // 節(jié)假日的中文名。
      "wage": 3,           // 薪資倍數(shù)，3表示是3倍工資
      "date": "2018-10-01" // 節(jié)假日的日期
    },
    "10-02": {
      "holiday": true,     // 該字段一定為true
      "name": "國慶節(jié)",     // 節(jié)假日的中文名。
      "wage": 3,           // 薪資倍數(shù)，3表示是3倍工資
      "date": "2018-10-01" // 節(jié)假日的日期
    }
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "2018-10-01": {             // 一一對應holiday對象的key，holiday有多少個這里就有多少個
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

http://timor.tech/api/holiday/year
http://timor.tech/api/holiday/year/2018/
http://timor.tech/api/holiday/year/2019-02

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

例如：使用文字轉(zhuǎn)語音，把返回的結(jié)果直接播放出來。適用于VUI語音交互中使用。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

接口地址: http://timor.tech/api/holiday/tts

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,       // 0服務正常。-1服務出錯
  "tts": "明天就是周六了，今天努力工作哦！。最近的一個節(jié)日是清明節(jié)。還要12天。早著呢！"
}

示例語句:

今天是周末，放松一下吧！
今天是國慶節(jié)前調(diào)休，明天就是國慶節(jié)了，加油！
你在想什么！今天就是國慶節(jié)啊。
清明節(jié)才剛剛過完，今天是清明節(jié)調(diào)休，老老實實上班吧。
很遺憾的告訴您，這周六要勞動節(jié)前調(diào)休，不過周日就是勞動節(jié)了。
很遺憾的告訴您，這周六和周日都要國慶節(jié)前調(diào)休。再過3天是國慶節(jié)。
明天就是中秋節(jié)了，開不開心？不過記得周日要中秋節(jié)調(diào)休，設置好鬧鐘，別玩太嗨。
明天就是周六了，今天努力工作哦！最近的一個節(jié)日是清明節(jié)。還要12天。早著呢！
還有很多情況的就不一一例舉了，目前大概有2/3十種不同的表達?？傊?，我會盡可能的用人類友好的表達方式。

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

接口地址: http://timor.tech/api/holiday/tts/next

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,        // 0服務正常。-1服務出錯
  "tts": "最近的一個節(jié)日是2018-04-05的清明節(jié)，還有11天。"
}

示例語句:

今年的所有節(jié)假日都過完了，2019年的節(jié)假日開發(fā)者還在偷懶。
最近的一個節(jié)日是2018-04-05的清明節(jié)，還有11天。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有9天。在這之前先要勞動節(jié)前調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有2天。不過記得明天先要勞動節(jié)前調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有21天。明天要記得清明節(jié)調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有22天。在這之前先把清明節(jié)調(diào)休完吧。
更多示例不一一例舉了，會根據(jù)時間不同，調(diào)整明天，后天等的表達。

返回文字?；卮鹈魈旆偶賳帷?/h4>

接口地址: http://timor.tech/api/holiday/tts/tomorrow

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,        // 0服務正常。-1服務出錯
  "tts": "明天是周一，今晚早點睡，上班別遲到了。"
}

示例語句:

明天是勞動節(jié)，趁著假期放松一下吧。
清明節(jié)才剛過完，明天都要清明節(jié)調(diào)休了，還想著放假呢！
明天是周六，放心睡吧。
今天才周二呢，先好好上班吧。
明天不放假，明天是勞動節(jié)前調(diào)休，馬上就是勞動節(jié)了，開心吧！

瀏覽器端使用 ajax 請求節(jié)假日服務示例代碼

// 注意：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)
  }
})

------------恢復內(nèi)容開始------------

獲取指定日期的節(jié)假日信息

接口地址：http://timor.tech/api/holiday/info/$date
@params $date: 指定日期的字符串，格式 ‘2018-02-23’。可以省略，則默認服務器的當前時間。
@return json: 如果不是節(jié)假日，holiday字段為null。

{　
  "code": 0,              // 0服務正常。-1服務出錯
  "type": {
    "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
    "name": "周六",         // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
    "week": enum(1 - 7)    // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
  },
  "holiday": {
    "holiday": false,     // true表示是節(jié)假日，false表示是調(diào)休
    "name": "國慶前調(diào)休",  // 節(jié)假日的中文名。如果是調(diào)休，則是調(diào)休的中文名，例如'國慶前調(diào)休'
    "wage": 1,            // 薪資倍數(shù)，1表示是1倍工資
    "after": false,       // 只在調(diào)休下有該字段。true表示放完假后調(diào)休，false表示先調(diào)休再放假
    "target": '國慶節(jié)'     // 只在調(diào)休下有該字段。表示調(diào)休的節(jié)假日
  }
}

示例：

http://timor.tech/api/holiday/info/2018-3-2
http://timor.tech/api/holiday/info/2018-03-02
http://timor.tech/api/holiday/info

批量查詢指定日期節(jié)假日信息

接口地址：http://timor.tech/api/holiday/batch?d=$date&type=Y

@params d: 指定日期的字符串，多個日期之間使用 & 連接。最大長度查詢個數(shù)50。兼容舊的格式用逗號,隔開，但不建議。格式 ‘2018-02-23’。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@return json: 返回以日期為key的對象。

{
  "code": 0,               // 0服務正常。-1服務出錯
  "holiday": {             // 傳過來的日期是什么，key就是什么。傳多少個就有多少個。
    "2017-10-01": {        // holiday的值都是一致的
      "holiday": true,
      "name": "國慶節(jié)",
      "wage": 2
    },
    "2017-9-12": null      // 如果不是節(jié)假日，則為null
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "2017-10-01": {             // 一一對應holiday對象的key，holiday有多少個這里就有多少個
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

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

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

接口地址: http://timor.tech/api/holiday/next/$date?type=Y&week=Y

@params $date: 指定日期的字符串，格式 ‘2018-02-23’?？梢允÷裕瑒t默認服務器的當前時間。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@params week: 節(jié)假日是否包含周末，默認不包含。可選值：’Y’ 包含周末，’N’ 不包含。
@return json: 返回指定日期的下一個最近的節(jié)假日，如果在放假之前要調(diào)休，則會一起返回調(diào)休的信息。如果包含周末，則節(jié)日和周末沖突時，以節(jié)日為優(yōu)先級。比如特殊情況：周六是調(diào)休，則holiday返回周日，workday返回周六。其它情況以此類推，holiday永遠會返回下一個節(jié)日。

{
  "code": 0,              // 0服務正常。-1服務出錯
  "holiday": {
    "holiday": true,      // 該字段一定為true
    "name": "國慶節(jié)",      // 節(jié)假日的中文名。
    "wage": 3,            // 薪資倍數(shù)，3表示是3倍工資
    "date": "2018-10-01"  // 節(jié)假日的日期
    "rest": 3             // 表示當前時間距離目標還有多少天。比如今天是 2018-09-28，距離 2018-10-01 還有3天
  },
  "workday": {             // 如果節(jié)假日前沒調(diào)休，則此字段為null
    "holiday": false,      // 此字段一定為false
    "name": "國慶前調(diào)休",   // 調(diào)休的中文名
    "wage": 1,            // 薪資倍數(shù)，3表示是3倍工資
    "after": false,       // true表示放完假后調(diào)休，false表示先調(diào)休再放假
    "target": '國慶節(jié)',    // 表示調(diào)休的節(jié)假日
    "date": "2018-09-29"  // 表示要調(diào)休的日期
    "rest": 1             // 同上。表示當前時間距離目標還有多少天。
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "holiday": {                // 對應 holiday 中的日期類型，只有返回 holiday 信息時才存在此日期類型
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    },
    "workday": {                // 對應 workday 中的日期類型，只有返回 workday 信息時才存在此日期類型
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

http://timor.tech/api/holiday/next/2018-6-1
http://timor.tech/api/holiday/next/2018-09-28
http://timor.tech/api/holiday/next

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

接口地址: http://timor.tech/api/holiday/workday/next/$date

@params $data: 指定日期的字符串，格式 ‘2020-01-20’?？梢允÷?，則默認服務器的當前時間。
@return json: 返回指定日期的下一個最近的工作日。工作日包含正常工作日、調(diào)休，不包含當天。

{
  "code": 0,                 // 0服務正常。-1服務出錯
  "workday": {               // 如果沒有查找到最近的工作日，則此字段為null。最大查找長度為30
    "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。此接口只會返回 0 和 3 的類型。
    "name": "周二",           // 工作日類型中文名，可能值為 周一 至 周五、某某調(diào)休。
    "week": enum(1 - 7)      // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    "date": "2018-09-29"     // 表示要工作的日期。
    "rest": 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

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

接口地址: http://timor.tech/api/holiday/year/$date?type=Y&week=Y

@params $date: 指定年份或年月份，格式 ‘2019-02’ ‘2019-2’ 或者 ‘2019’?？梢允÷裕瑒t默認服務器當前時間的年份。
@params type: 是否返回日期類型，默認不返回?？蛇x值：’Y’ 返回，’N’ 不返回。
@params week: 節(jié)假日是否包含周末，默認不包含。可選值：’Y’ 包含周末，’N’ 不包含。
@return json: 返回指定年份或年月份的所有節(jié)假日，以日期作為key，格式：mm-dd。如果沒有該年份或月份，則返回空對象。注意目前只配置了最多比當前時間往后一年的節(jié)假日。如果包含周末，則節(jié)日和周末沖突時，以節(jié)日為準。

{
  "code": 0,               // 0服務正常。-1服務出錯
  "holiday": {
    "10-01": {
      "holiday": true,     // 該字段一定為true
      "name": "國慶節(jié)",     // 節(jié)假日的中文名。
      "wage": 3,           // 薪資倍數(shù)，3表示是3倍工資
      "date": "2018-10-01" // 節(jié)假日的日期
    },
    "10-02": {
      "holiday": true,     // 該字段一定為true
      "name": "國慶節(jié)",     // 節(jié)假日的中文名。
      "wage": 3,           // 薪資倍數(shù)，3表示是3倍工資
      "date": "2018-10-01" // 節(jié)假日的日期
    }
  },
  "type": {                     // 只有明確指定參數(shù) type=Y 時才返回類型信息
    "2018-10-01": {             // 一一對應holiday對象的key，holiday有多少個這里就有多少個
      "type": enum(0, 1, 2, 3), // 節(jié)假日類型，分別表示 工作日、周末、節(jié)日、調(diào)休。
      "name": "周六",            // 節(jié)假日類型中文名，可能值為 周一 至 周日、假期的名字、某某調(diào)休。
      "week": enum(1 - 7)       // 一周中的第幾天。值為 1 - 7，分別表示 周一 至 周日。
    }
  }
}

示例：

http://timor.tech/api/holiday/year
http://timor.tech/api/holiday/year/2018/
http://timor.tech/api/holiday/year/2019-02

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

例如：使用文字轉(zhuǎn)語音，把返回的結(jié)果直接播放出來。適用于VUI語音交互中使用。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

接口地址: http://timor.tech/api/holiday/tts

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,       // 0服務正常。-1服務出錯
  "tts": "明天就是周六了，今天努力工作哦！。最近的一個節(jié)日是清明節(jié)。還要12天。早著呢！"
}

示例語句:

今天是周末，放松一下吧！
今天是國慶節(jié)前調(diào)休，明天就是國慶節(jié)了，加油！
你在想什么！今天就是國慶節(jié)啊。
清明節(jié)才剛剛過完，今天是清明節(jié)調(diào)休，老老實實上班吧。
很遺憾的告訴您，這周六要勞動節(jié)前調(diào)休，不過周日就是勞動節(jié)了。
很遺憾的告訴您，這周六和周日都要國慶節(jié)前調(diào)休。再過3天是國慶節(jié)。
明天就是中秋節(jié)了，開不開心？不過記得周日要中秋節(jié)調(diào)休，設置好鬧鐘，別玩太嗨。
明天就是周六了，今天努力工作哦！最近的一個節(jié)日是清明節(jié)。還要12天。早著呢！
還有很多情況的就不一一例舉了，目前大概有2/3十種不同的表達。總之，我會盡可能的用人類友好的表達方式。

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

接口地址: http://timor.tech/api/holiday/tts/next

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,        // 0服務正常。-1服務出錯
  "tts": "最近的一個節(jié)日是2018-04-05的清明節(jié)，還有11天。"
}

示例語句:

今年的所有節(jié)假日都過完了，2019年的節(jié)假日開發(fā)者還在偷懶。
最近的一個節(jié)日是2018-04-05的清明節(jié)，還有11天。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有9天。在這之前先要勞動節(jié)前調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有2天。不過記得明天先要勞動節(jié)前調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有21天。明天要記得清明節(jié)調(diào)休。
最近的一個節(jié)日是2018-04-28的勞動節(jié)，還有22天。在這之前先把清明節(jié)調(diào)休完吧。
更多示例不一一例舉了，會根據(jù)時間不同，調(diào)整明天，后天等的表達。

返回文字?；卮鹈魈旆偶賳帷?/h4>

接口地址: http://timor.tech/api/holiday/tts/tomorrow

@params: 沒有參數(shù)
@return json: 返回可直接播放的文字。

{
  "code": 0,        // 0服務正常。-1服務出錯
  "tts": "明天是周一，今晚早點睡，上班別遲到了。"
}

示例語句:

明天是勞動節(jié)，趁著假期放松一下吧。
清明節(jié)才剛過完，明天都要清明節(jié)調(diào)休了，還想著放假呢！
明天是周六，放心睡吧。
今天才周二呢，先好好上班吧。
明天不放假，明天是勞動節(jié)前調(diào)休，馬上就是勞動節(jié)了，開心吧！

瀏覽器端使用 ajax 請求節(jié)假日服務示例代碼

// 注意：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)
  }
})

------------恢復內(nèi)容結(jié)束------------

posted @ 2021-05-21 17:29 葉不知秋閱讀(2221) 評論(0) 收藏舉報

刷新頁面返回頂部

葉不知秋

免費節(jié)假日 API

轉(zhuǎn)載地址：http://timor.tech/api/holiday

獲取指定日期的節(jié)假日信息

示例：

批量查詢指定日期節(jié)假日信息

示例：

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

示例：

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

示例：

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

示例：

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

示例語句:

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

示例語句:

返回文字?；卮鹈魈旆偶賳?。

示例語句:

瀏覽器端使用 ajax 請求節(jié)假日服務示例代碼

獲取指定日期的節(jié)假日信息

示例：

批量查詢指定日期節(jié)假日信息

示例：

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

示例：

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

示例：

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

示例：

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

示例語句:

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

示例語句:

示例語句:

瀏覽器端使用 ajax 請求節(jié)假日服務示例代碼

獲取指定日期的節(jié)假日信息

示例：

批量查詢指定日期節(jié)假日信息

示例：

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

示例：

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

示例：

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

示例：

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

示例語句:

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

示例語句:

示例語句:

瀏覽器端使用 ajax 請求節(jié)假日服務示例代碼

公告

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。

返回文字?；卮鹈魈旆偶賳?。

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

獲取指定年份或年月份的所有節(jié)假日信息。默認返回當前年份的所有信息。

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

獲取指定日期的下一個節(jié)假日（如果在放假前有調(diào)休，也會返回）

獲取指定日期的下一個工作日（工作日包含正常工作日、調(diào)休）不包含當天

下面是高級API。返回人類可閱讀的文字，適用于語音交互中。

返回文字。距離今天最近的一個放假安排。周六周末、調(diào)休、節(jié)假日都會考慮，比較全面的放假安排。

返回文字。距離今天最近的一個節(jié)假日安排。只考慮節(jié)假日和調(diào)休。