背景

之前有寫過一個定時任務的專案，主要是在工作日進行一些資料推送和任務提醒。為了精確的判斷當天是否為工作日（這裡包含了正常上班日和法定節假日的補班），在網上看到了一個api，用下來也挺穩定的。但是本人喜歡折騰，並且依賴別人的api總歸不可靠，所以抽時間寫了這個工具，也算是重複造了個輪子吧，大家有需要的可以拿去用，目前已經發布到pypi，可以直接通過pip安裝

工具說明

名稱

get_holiday_cn 獲取中國法定節假日

支援的python版本

python3.x

功能點

1. 傳入日期獲取中國法定節假日

依賴說明

依賴NateScarlet/holiday-cn

安裝

pip install get_holiday_cn
 

資料說明

{
      "code": 0,              // 0服務正常。-1服務出錯
      "type": {
        "type": enum(0, 1, 2, 3), // 節假日型別，分別表示 工作日、週末、節日、調休。
        "name": "週六",         // 節假日型別中文名，可能值為 週一 至 週日、假期的名字、某某調休。
        "week": enum(1 - 7)    // 一週中的第幾天。值為 1 - 7，分別表示 週一 至 週日。
        "status": enum(0, 1)    // 資料場景型別，0來源於倉庫中或者正常的上班日，資料可靠；1表示當前傳入日期在倉庫中未查詢到，直接走系統計算，資料不可靠。
      },
      "holiday": {            // 只有當type為2，3時，該物件才存在
        "holiday": false,     // true表示是節假日，false表示是調休
        "name": "國慶節調休",  // 節假日的中文名。如果是調休，則是調休的中文名，例如'國慶節調休'
        "date": '2021-10-09'     // 當前請求的日期
      }
}
 

使用

from get_holiday_cn.client import getHoliday

client = getHoliday()
# 獲取今日資料
print(client.assemble_holiday_data())
# 指定日期獲取資料
print(client.assemble_holiday_data(today='2021-10-01'))

Github地址

https://github.com/longweiqiang/get_holiday_cn