calendar模块是与日历相关的模块,该模块定义了很多类型,主要包括:Calendar、TextCalendar、HTMLCalendar,其中 Calendar 是 TextCalendar 和 HTMLCalendar 的基类,这些类有着十分丰富的日历处理方法。

calendar 模块

对于简单的文本日历,我们使用 calendar 模块直接调用的方法或属性即可

setfirstweekday(firstweekday)

设置每一周的开始(0 表示星期一,6 表示星期天),calendar 提供了 MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY 和 SUNDAY 几个常量方便使用

例如,设置每周的第一天为星期天,示例如下:

1 importcalendar
2 calendar.setfirstweekday(calendar.SUNDAY)
firstweekday()

返回当前设置的每星期的第一天的数值,默认为星期一。示例如下:

import calendar
print(calendar.firstweekday())
isleap(year)

如果 year 是闰年则返回 True,否则返回 False。示例如下:

1 importcalendar
2 print(calendar.isleap(9102))
leapdays(y1, y2)

返回在范围 y1 至 y2 (包含 y1 和 y2 )之间的闰年的年数,其中 y1 和 y2 是年份。示例如下:

import calendar
print(calendar.leapdays(1945,2019))
weekday(year, month, day)

返回一周中的某一天 ( 0 ~ 6 代表周一至周日)。示例如下:

1 importcalendar
2 print(calendar.weekday(2019,10,1))
monthrange(year, month)

返回指定年、月份第一天是星期几和这个月的天数。示例如下:

1 importcalendar
2 print(calendar.monthrange(2019, 10))
monthcalendar(year, month)

返回表示一个月的日历的矩阵,每一行代表一周,此月份外的日子由零表示,每周默认从周一开始,可使用 setfirstweekday() 改变默认值。示例如下:

1 importcalendar
2 print(calendar.monthcalendar(2019,10))
prmonth(theyear, themonth, w=0, l=0)

打印由 month() 返回的一个月的日历,每日宽度间隔为 w 字符,l 是每星期的行数。

prcal(year, w=0, l=0, c=6, m=3)

打印由 calendar() 返回的整年的日历。

day_name

在当前的语言环境下表示星期几的列表。

day_abbr

在当前语言环境下表示星期几缩写的列表。

month_name

在当前语言环境下表示一年中月份的列表,一月的月号为 1,它的长度为 13 且 month_name[0] 是空字符串。

month_abbr

在当前语言环境下表示月份简写的列表。

Calendar 类

Calendar 对象提供了一些可被用于准备日历数据格式化的方法,这个类本身不执行任何格式化操作,这部分任务应由子类来完成,

iterweekdays()

返回一个迭代器,迭代器的内容为一星期的数字。

1 from calendar importCalendar2 c =Calendar()3 print(list(c.iterweekdays()))
itermonthdates(year, month)

返回一个迭代器,迭代器的内容为 year 年 month 月(1-12)的日期。

itermonthdays2(year, month)

返回一个迭代器,迭代器的内容与 itermonthdates() 类似为 year 年 month 月的日期,但不受 datetime.date 范围的限制,迭代器中的元素为一个由日期和代表星期几的数字组成的的元组。

itermonthdays3(year, month)

返回一个迭代器,迭代器的内容与 itermonthdates() 类似为 year 年 month 月的日期,不受 datetime.date 范围的限制,迭代器的元素为一个由年、月、日组成的元组。

1 from calendar importCalendar2 c =Calendar()3 print(list(c.itermonthdays3(2019,10)))

TextCalendar 类

TextCalendar 对象提供了一些生成纯文本日历的方法,

formatmonth(theyear, themonth, w=0, l=0)

返回一个多行字符串来表示指定年月的日历,w 为日期的宽度,始终保持日期居中,l 指定了每星期占用的行数;

以上这些还依赖于构造器或者 setfirstweekday() 方法指定的周的第一天是哪一天。

1 from calendar importTextCalendar2 tc =TextCalendar()3 print(tc.formatmonth(2019,10))
prmonth(theyear, themonth, w=0, l=0)

与 formatmonth() 方法一样,返回一个月的日历。

formatyear(theyear, w=2, l=1, c=6, m=3)

返回一个多行字符串,这个字符串为一个 m 列日历,可选参数 w、l、c 分别表示日期列数、周的行数、月之间的间隔;以上这些还依赖于构造器或者 setfirstweekday() 指定哪一天为一周的第一天。

pryear(theyear, w=0, l=0, c=6, m=3)

与 formatyear() 方法一样,返回一整年的日历。

HTMLCalendar 类

HTMLCalendar 对象提供了一些生成 HTML 日历的方法

formatmonth(theyear, themonth, withyear=True)

返回一个 HTML 表格作为指定年月的日历,withyear 为 True,则年份将会包含在表头,否则只显示月份。

1 from calendar importHTMLCalendar2 hc =HTMLCalendar()3 print(hc.formatmonth(2019,10))
formatyear(theyear, width=3)

返回一个 HTML 表格作为指定年份的日历,width 用于规定每一行显示月份的数量。

formatyearpage(theyear, width=3, css='calendar.css', encoding=None)

返回一个完整的 HTML 页面作为指定年份的日历,width 用于规定每一行显示的月份数量,css 为层叠样式表的名字,如果不使用任何层叠样式表,可以使用 None,encoding 为输出页面的编码 (默认为系统的默认编码)。