calendar库让你可以输出日历,它还提供了其它与日历相关的实用函数。本篇,就将详细讲解calendar库的使用规则。
prmonth()是一个简单的函数,可以生成月的格式文本输出。具体用法如下所示:
运行之后,我们会得到一个日历字符串形式数据:
可以看到,日历开始是从星期一开始的。这是因为我们通过函数TextCalendar()指定了日历的开始星期。这里,读者可以自行指定任意一个星期几。
这里,我们直接替换掉上面的c.prmonth()。代码如下:
运行之后,我们会得到如下结果:
这里,我们会直接返回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个参数:整型年份 | 返回整年日历 |
测试代码如下所示:
运行之后,效果如下:
这些都是常用的函数,但是其实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 | 无参数 | 迭代指定的星期数 |
测试代码如下:
运行之后,效果如下:
假如你现在的公司每月的第2个星期3都要召开大会,那么怎么提前获取日期提醒自己呢?calendar库实现这种操作非常的容易。具体代码如下所示:
运行之后,效果如下:
上面我们返回的日历大多都是英文的。这在中文网页中是不是显示的非常不友好。没关系,我们可以使用本地化环境函数LocaleTextCalendar或LocaleHTMLCalendar实现中文日历的显示。
具体代码如下:
运行之后,效果如下: