Python calendar模块详解:类结构与常用方法实战
本文详细介绍Python标准库中的calendar模块,涵盖其基于datetime的计算机制、首周设置及三大核心类(Calendar、TextCalendar、HTMLCalendar)的结构。通过具体代码示例,演示如何生成年历、月历及HTML格式日历,帮助开发者高效处理日期集合与日历展示需求。
回顾之前的内容:
Python在时间日期操作方面提供了丰富的方法,此前我们已经学习了两个相关模块:
- 受限于Unix时间戳范围(1970年至2038年)的time模块,用于处理具体时间戳;
- 包含六个类、提供更人性化时间日期处理的datetime模块;

在日常工作和生活中,除了对单一时间及日期的处理Python外,若需处理日期的集合,应使用哪个模块呢?
Python专门提供了calendar模块来处理日历相关操作。接下来,我们将学习calendar模块的相关方法及属性。
1. calendar 模块概述
calendar 模块提供了一系列与日历相关的实用函数,旨在帮助用户获取日历相关信息。
1.1 calendar 特点
calendar模块基于datetime.date.weekday()来计算每周的周数;calendar默认将星期一作为每周的第一天,星期日作为每周的最后一天;calendar提供了calendar.setfirstweeksday()函数,允许用户更改指定星期几作为一周的第一天;
1.2 calendar 类结构
- 我们可以查看
Python内置库中的-calendar.py文件; calendar主要提供三大类:Calendar、TextCalendar以及HTMLCalendar;- 其中,
calendar是TextCalendar和HTMLCalendar的基类;

1.3 calendar 使用步骤
calendar作为内置库,可直接使用import语句进行导入;
import calendar
2. calendar 相关方法
2.2 calendar 模块相关方法
| 方法 | 说明 |
|---|---|
| calendar.firstweekday() | 设置每星期的第一天数值 |
| calendar.isleap(year) | 判断是闰年,则返回Ture |
| calendar.leapdays(y1,y2) | 计算要y1与y2的闰年数 |
| calendar.weekday(year,month,day) | 返回某日是星期几 |
| calendar.weekheader(n) | 星期几的缩写名的头 |
| calendar.mothrange(year,month) | 计算出指定年份的某月第一天是星期几和天数 |
| calendar.prmonth(theyear,themonth,w=0,1=0) | 格式化打印指定年的某月的日历 |
| calendar.month(theyear,themonth,w=0,1=0) | 使用TextCalendar类formation()以多行字符串形式返回月份日历 |
| calendar.prcal(year,w=1,1=0,c=6,m=3) | 格式化打印出整年的日历 |
| calendar.calendar(year,w=1,1=0,c=6,m=3) | 以整年3列的日历多行字符串的形式的日历 |
2.3 calendar 模块属性
| 方法 | 说明 |
|---|---|
| calendar.day_name | 当前语言环境下星期几的数组 |
| calendar.day_abbr | 当前语言环境下星期几的缩写 |
| calendar.month_name | 当前语言下一年的月份数组 |
| calendar.month_abbr | 当前语言下一年的月份缩写 |
2.4 calendar 模块提供5个类
| 类方法 | 说明 |
|---|---|
| calendar.Calendar(firstweekday=0) | 创建Calendar对象,默认周一为第一天 |
| calendar.TextCalendar(firstweekday=0) | 生成纯文本日历对象 |
| calendar.HTMLCalendar(firstweekday=0) | 生成HTML日志对象 |
| calendar.LocaleTextCalenda(firstweekday=0,locale=None) | 语言环境名称 |
| calendar.LocaleHTMLCalendar(firstweekday=0,locale=None) | 语言环境名称 |
2.5 calendar.Calendar类实例相关方法
| 方法 | 说明 |
|---|---|
| cal.itermonthdates(year,month) | 返回一个year年month月的日期的迭代器 |
| cal.iterweekdats() | 返回为一星期的数字的迭代器 |
| cal.itermonthdays(year,month) | 返回的日期为当月每一天的日期对应的天数,对于不在当月的日期,会显示0 |
| cal.itermonthdays2(year,month) | 返回一个由日期和代表星期几的数字组成的元组 |
| cal.itermonthdays3(year,month) | 返回一个由年月日组成的元组 |
| cal.itermonthdays4(year,month) | 返回一个由年月日和星期几的数字组成的元组 |
| cal.monthdatescalendar(year,month) | 返回一个由datetime.date对象组成的年月的周列表 |
| cal.monthdays2calendar(year,month) | 返回一个由日期数字和周几的数字的二元元组 |
| cal.monthdayscalendar(year,month) | 返回一个由七个日期数字的组成周列表 |
| cal.yeardatescalendar(year,width=3) | 返回可以用来格式化的指定年月的数据列表 |
| cal.yeardays2calendar(year,width=3) | 返回用来模式化的指定年月的数据。在这个月的日期为0,周列表由日期和星期数组成的元组 |
| cal.yeardayscalendar(year,width=3) | 返回一个周列表是日期数字组成可以用来模式化的指定年月的数据 |
2.6 calendar.TextCalendar类实例相关方法
| 方法 | 说明 |
|---|---|
| tc.formatmonth(theyear,themonth,w=0,1=0) | 以多行字符串来表示指定年月的日历 |
| tc.prmonth(theyear,themonth,w=0,1=0) | 格式化打印一个月的日历 |
| tc.formatyear(theyear,w=0,1=1,c=6,m=3) | 返回一个m列的日历 |
| tc.pryear(theyear,w=0,1=1,c=6,m=3) | 格式化打印一整年的日历 |
2.7 calendar.HTMLCalendar类实例相关方法
| 方法 | 说明 |
|---|---|
| htl.formatmonth(theyear,themonth,withyear=True) | 返回一个HTML表格的指定的年月日历 |
| htl.formatyear(theyear,width=3) | 返回HTML指定年份的日历 |
| htl.formatyearpage(theyear,width=3,css='calendar.css',encoding=None) | 返回一个完整的HTML页面作为指定的年份日历 |
2.8 calendar.HTMLCalendar类实例相关属性
| 方法 | 说明 |
|---|---|
| htl.cssclasses | 星期一到星期天的CSS class 列表 |
| htl.cssclass_noday | 工作日的CSS类在上个月或下个月发生 |
| htl.cssclasses_weekday_head | 用于标题行中工作日名称的css列表 |
| htl.cssclass_month_head | 月份的CSS列表标题 |
| htl.cssclass_month | 某个月的月历CSS类 |
| htl.cssclass_year | 某个年的年历CSS类 |
| htl.cssclasses_year_head | 年历的CSS列表标题 |
3. 实操
打印2021年年历
import calendar
# 打印2021年历
print(calendar.calendar(2021))

打印指定某年的月历
print(calendar.month(2021,11))
4、总结
通过对calendar模块日历相关方法的学习,可知该模块主要提供Calendar、TextCalendar和HTMLCalendar三个核心类。利用这些类,我们可以更好地以字符串或HTML形式打印出指定的日历。
到此这篇关于Python calendar模块详情的文章就介绍到这了,更多相关Python calendar模块内容请搜索本站以前的文章或继续浏览下面的相关文章,希望大家以后多多支持本站!
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













