calendar:Python日历的处理与生成

发布时间 2023-09-28 14:17:07作者: 阿瑞娜

前言

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

运行之后,效果如下: