前言
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))
运行之后,效果如下: