README.md

chinaholiday

单文件版中国节假日, 支持2007-2020, python3

快速上手

#引入包
from chinaholiday import ChinaHoliday
ch = ChinaHoliday()

ch.get_info("20190427")
#返回: 
# {
# 'day': datetime.date(2019, 4, 27),
# 'is_public_holiday': False,
# 'public_holiday_name': '非法定节假日',
# 'is_holiday': True,
# 'holiday_name': '周末'
# }

import datetime
ch.get_info(datetime.date(2019, 4, 28))
#返回:
#{
# 'day': datetime.date(2019, 4, 28),
# 'is_public_holiday': False,
# 'public_holiday_name': '工作日(劳动节调休)',
# 'is_holiday': False,
# 'holiday_name': '工作日(劳动节调休)'
# }

#示例: 根据今天是否放假执行操作(e.g. 开启闹钟)
if ch.is_holiday("today"):
    # True放假
    pass #do something
else:
    #False 不放假
    pass #do something

#示例: 判断明天类型
res = ch.is_public_holiday("tomorrow")
if res: # 此时 res = True
    print("明天是公共节假日")
else: # 此时 not res = True
    print("明天不是公共节假日")
    # 你还可以进一步用False或None区分何种上班日
    if res is False:
        print("明天是周末调为上班日")
    elif res is None:
        print("明天是普通上班日")

详细使用

使用print(ChinaHoliday.__doc__)查看详细文档

# 判断某天是否是公共节假日/休息日/工作日 (支持2007年-2020年)
# e.g.
day = "20180101" # or datatime.day(2018, 1, 1), or 'today'/'tomorrow'/'yesterday'
ch = ChinaHoliday()
# methods
ch.get_info(day) #获取完整信息
ch.is_public_holiday(day) # True公共节假日, 否则为上班日: False周末调为上班日, None普通上班日
ch.is_holiday(day) # True放假, False不放假
ch.is_workday(day) # is_holiday(day)反过来
# properties
ch.public_holidays #所有公共节假日和调休, 格式(day, is_public_holiday, name)
ch.today #今天(type datatime.date)

修改

原始数据在python中, 以ini方式整理, 非常方便修改