Skip to main content

check if some day is holiday in China

Project description


Package Travis License README

判断某年某月某一天是不是工作日/节假日。 支持 2004年 至 2022年,包括 2020年 的春节延长。


pip install chinesecalendar


import datetime

# 判断 2018年4月30号 是不是节假日
from chinese_calendar import is_holiday, is_workday
april_last =, 4, 30)
assert is_workday(april_last) is False
assert is_holiday(april_last) is True

# 或者在判断的同时,获取节日名
import chinese_calendar as calendar  # 也可以这样 import
on_holiday, holiday_name = calendar.get_holiday_detail(april_last)
assert on_holiday is True
assert holiday_name == calendar.Holiday.labour_day.value

# 还能判断法定节假日是不是调休
import chinese_calendar
assert chinese_calendar.is_in_lieu(, 2, 1)) is False
assert chinese_calendar.is_in_lieu(, 2, 2)) is True


假如你没法使用Python, 你也可以转译现成的常量文件来获取最全的节假日安排表。


  1. Fork + Clone 项目到本地
  2. 修改节假日定义
  3. 执行脚本自动生成常量文件
  4. 提交PR

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chinese_calendar-1.7.1.tar.gz (11.6 kB view hashes)

Uploaded Source

Built Distribution

chinese_calendar-1.7.1-py2.py3-none-any.whl (11.1 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page