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 为输出页面的编码 (默认为系统的默认编码)。