calendar：Python日历的处理与生成

前言

calendar库让你可以输出日历，它还提供了其它与日历相关的实用函数。本篇，就将详细讲解calendar库的使用规则。

prmonth()与TextCalendar()

prmonth()是一个简单的函数，可以生成月的格式文本输出。具体用法如下所示：

import calendar

c = calendar.TextCalendar(calendar.MONDAY)
c.prmonth(2020, 4)

运行之后，我们会得到一个日历字符串形式数据：

可以看到，日历开始是从星期一开始的。这是因为我们通过函数TextCalendar()指定了日历的开始星期。这里，读者可以自行指定任意一个星期几。

HTMLCalendar().formatmonth

这里，我们直接替换掉上面的c.prmonth()。代码如下：

import calendar

c = calendar.TextCalendar(calendar.MONDAY)
print(calendar.HTMLCalendar().formatmonth(2020,4))

运行之后，我们会得到如下结果：

这里，我们会直接返回HTML表格定义的日历格式。在使用Django开发时，这个方法非常好用。而且，细心的读者肯定看到了这里每一个标签都有class，在实际的使用中，可以通过CSS丰富这个日历的样式。

其他方法

一个一个方法讲解太麻烦了，博主这里整理了一个表格，专门列出了calendar库各个方法的使用规则：

方法名	参数	意义
weekday	3个整型参数：年，月，日	返回日期星期几[0-6]
isleap	1个整型年份	用来判断是否时闰年
leapdays	2个整型年	两个年份之间的闰年有多少个
weekheader	1个整型数字	返回星期对应缩写，参数代表缩写英文的长度
monthcalendar	2个参数：整型年，月	返回一个月的日历矩阵
timegm	1个struct_time结构体日期	将日期转换为时间戳
prmonth	2个参数：整型年，月	返回当月日历
prcal	1个参数：整型年份	返回整年日历

测试代码如下所示：

import calendar, datetime

c = calendar.TextCalendar(calendar.MONDAY)
# 返回日期星期几[0-6]
print(calendar.weekday(2021, 4, 12))
# 用来判断是否时闰年
print(calendar.isleap(2021))
# 两个年份之间的闰年有多少
print(calendar.leapdays(2000, 2050))
# 返回星期对应缩写，参数代表缩写英文的长度
print(calendar.weekheader(2))
# 返回一个月的日历矩阵
print(calendar.monthcalendar(2021, 4))
# 将日期转换为时间戳
print(calendar.timegm(datetime.datetime(2021, 4, 3).timetuple()))
# 返回当月日历
print(calendar.prmonth(2021, 4))
# 返回整年日历
print(calendar.prcal(2021))

运行之后，效果如下：

这些都是常用的函数，但是其实calendar库还有许多迭代的函数提供大家使用，可以返回任意数据类型的元组或者列表。如下表所示：

方法名	参数	意义
yeardays2calendar	2个整型参数：年，N月一个分组	月行序列，元组为（月份号，星期几[0-6]），月份号为0时，不作数(下同)，每3个月为一组数据
yeardatescalendar	2个整型参数：年，N月一个分组	返回datetime.date日期列表，每N个月为一组数据
yeardayscalendar	2个整型参数：年，N月一个分组	返回日期列表，每N个月为一组数据
monthdatescalendar	2个整型参数：年，月	返回一个指定年月的周列表,列表日期类型为datetime.date
monthdays2calendar	2个整型参数：年，月	直接返回元组列表，元组由月份号与星期几构成
monthdayscalendar	2个整型参数：年，月	直接返回星期对应的日期列表
itermonthdates	2个整型参数：年，月	迭代月份对应的日期
itermonthdays2	2个整型参数：年，月	迭代月份对应的星期元组，元组包括当月的月号以及星期几
itermonthdays3	2个整型参数：年，月	迭代月份对应的日历元组，以设定的星期开头，元组包括年月日
itermonthdays4	2个整型参数：年，月	迭代月份对应的日历元组，以设定的星期开头，元组包括年月日星期几
itermonthdays	2个整型参数：年，月	迭代月份对应的月号整型，以设定的星期开头
iterweekdays	无参数	迭代指定的星期数

测试代码如下：

import calendar, datetime

c = calendar.TextCalendar(calendar.MONDAY)
# 下面所有星期开始以上面指定的星期一为准
# 月行序列，元组为（月份号，星期几[0-6]），月份号为0时，不作数(下同)，每3个月为一组数据
for i in c.yeardays2calendar(2021, width=3):
    print(i)
# 返回datetime.date日期列表，每3个月为一组数据
for i in c.yeardatescalendar(2021, 3):
    print(i)
# 返回日期列表，每3个月为一组数据
for i in c.yeardayscalendar(2021, 3):
    print(i)
# 返回一个指定年月的周列表,列表日期类型为datetime.date
for i in c.monthdatescalendar(2021, 3):
    print(i)
# 直接返回元组列表，元组由月份号与星期几构成
for i in c.monthdays2calendar(2021, 3):
    print(i, end="")
print()
# 直接返回星期对应的日期列表
for i in c.monthdayscalendar(2021, 3):
    print(i, end="")
print()
# 迭代指定的星期数
for i in c.iterweekdays():
    print(i, end="")
print()
# 迭代月份对应的日期
for i in c.itermonthdates(2021, 4):
    print(i, end="")
print()
# 迭代月份对应的星期元组，元组包括当月的月号以及星期几
for i in c.itermonthdays2(2021, 4):
    print(i, end="")
print()
# 迭代月份对应的日历元组，以星期1开头，元组包括年月日
for i in c.itermonthdays3(2021, 4):
    print(i, end="")
print()
# 迭代月份对应的日历元组，以星期1开头，元组包括年月日星期几
for i in c.itermonthdays4(2021, 4):
    print(i, end="")
# 迭代月份对应的月号整型，以星期1开头
print()
for i in c.itermonthdays(2021, 4):
    print(i, end="")

运行之后，效果如下：

实战（获取每月第2个星期3日期）

假如你现在的公司每月的第2个星期3都要召开大会，那么怎么提前获取日期提醒自己呢？calendar库实现这种操作非常的容易。具体代码如下所示：

import calendar

for month in range(1, 13):
    # 返回一个月的日历矩阵
    c = calendar.monthcalendar(2021, month)
    first_week = c[0]
    second_week = c[1]
    third_week = c[2]
    if first_week[calendar.WEDNESDAY] == 0:
        myDate = second_week[calendar.WEDNESDAY]
    else:
        myDate = third_week[calendar.WEDNESDAY]
    print(calendar.month_abbr[month], myDate)

运行之后，效果如下：

本地化环境

上面我们返回的日历大多都是英文的。这在中文网页中是不是显示的非常不友好。没关系，我们可以使用本地化环境函数LocaleTextCalendar或LocaleHTMLCalendar实现中文日历的显示。

具体代码如下：

import calendar

c = calendar.LocaleTextCalendar(locale="zh_CN")
c.prmonth(2021, 4)

c = calendar.LocaleHTMLCalendar(locale="zh_CN")
print(c.formatmonth(2021, 4))

运行之后，效果如下：