前言

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库各个方法的使用规则：

测试代码如下所示：

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库还有许多迭代的函数提供大家使用，可以返回任意数据类型的元组或者列表。如下表所示：

测试代码如下：

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))

运行之后，效果如下：