Python内置模块calendar:通用日历相关函数详解
知识导图
1. 模块概述
calendar 是Python内置的一个处理日历相关功能的模块，提供了多种生成日历、日期计算和格式化输出的函数。它基于Gregorian日历(公历)，支持多种日历视图和日期操作。
2. 日历生成
2.1 monthcalendar() 函数
定义：返回一个月的日历，以每周为列表的列表形式表示。
原型：
calendar.monthcalendar(year, month)
参数：
- year：年份(整数)
- month：月份(1-12)
返回值：一个列表的列表，每周为一个子列表，包含该周的日期(0表示不属于该月的日期)
示例：
import calendar
# 获取2023年10月的日历
oct_cal = calendar.monthcalendar(2023, 10)
for week in oct_cal:
print(week)
输出示例：
[0, 0, 0, 0, 0, 1, 2]
[3, 4, 5, 6, 7, 8, 9]
[10, 11, 12, 13, 14, 15, 16]
[17, 18, 19, 20, 21, 22, 23]
[24, 25, 26, 27, 28, 29, 30]
[31, 0, 0, 0, 0, 0, 0]
要点：
- 每周从周一开始(可通过setfirstweekday()改变)
- 0表示不属于该月的日期
- 可用于生成自定义日历视图
2.2 prmonth() 和 month() 函数
prmonth()：直接打印指定月份的日历
month()：返回指定月份的日历字符串
原型：
calendar.prmonth(year, month[, w[, l]])
calendar.month(year, month[, w[, l]])
参数：
- year：年份
- month：月份
- w：每个日期的宽度(默认2)
- l：每周的行数(默认1)
示例：
import calendar
# 直接打印2023年10月日历
calendar.prmonth(2023, 10)
# 获取2023年10月日历字符串
oct_cal_str = calendar.month(2023, 10)
print(oct_cal_str)
3. 日期计算
3.1 weekday() 函数
定义：返回指定日期的星期几(0-6，周一为0)
原型：
calendar.weekday(year, month, day)
参数：
- year：年份
- month：月份
- day：日
返回值：星期几(0-6)
示例：
import calendar
# 获取2023年10月1日是星期几
weekday = calendar.weekday(2023, 10, 1)
print(f"2023-10-01是星期{weekday+1}") # 输出: 2023-10-01是星期7 (因为周一为0)
3.2 monthrange() 函数
定义：返回指定月份的第一天是星期几和该月的天数
原型：
calendar.monthrange(year, month)
参数：
- year：年份
- month：月份
返回值：元组(第一天是星期几, 该月天数)
示例：
import calendar
# 获取2023年10月的信息
first_weekday, month_days = calendar.monthrange(2023, 10)
print(f"2023年10月第一天是星期{first_weekday+1}, 共{month_days}天")
3.3 isleap() 和 leapdays() 函数
isleap()：判断是否为闰年
leapdays()：返回两个年份之间的闰年数量
原型：
calendar.isleap(year)
calendar.leapdays(y1, y2)
示例：
import calendar
# 判断2024年是否为闰年
print(calendar.isleap(2024)) # True
# 计算2000-2020年之间的闰年数量
print(calendar.leapdays(2000, 2020)) # 6
4. 格式化输出
4.1 formatmonth() 函数
定义：返回格式化的月份日历字符串
原型：
calendar.formatmonth(year, month[, w[, l]])
参数：
- year：年份
- month：月份
- w：每个日期的宽度(默认2)
- l：每周的行数(默认1)
示例：
import calendar
# 获取格式化的2023年10月日历
oct_cal = calendar.formatmonth(2023, 10)
print(oct_cal)
4.2 prcal() 和 calendar() 函数
prcal()：直接打印全年日历
calendar()：返回全年日历字符串
示例：
import calendar
# 直接打印2023年日历
calendar.prcal(2023)
# 获取2023年日历字符串
year_cal = calendar.calendar(2023)
print(year_cal)
5. 其他功能
5.1 setfirstweekday() 和 firstweekday()
setfirstweekday()：设置每周的第一天(0-6，周一为0)
firstweekday()：获取当前设置的第一天
原型：
calendar.setfirstweekday(weekday)
calendar.firstweekday()
示例：
import calendar
# 设置每周的第一天为周日(6)
calendar.setfirstweekday(calendar.SUNDAY)
# 获取当前设置的第一天
print(calendar.firstweekday()) # 6
5.2 timegm() 函数
定义：将时间元组转换为时间戳(与time.gmtime()相反)
原型：
calendar.timegm(tuple)
参数：时间元组(与time.gmtime()返回的格式相同)
返回值：时间戳(浮点数)
示例：
import calendar
import time
# 将时间元组转换为时间戳
t = (2023, 10, 1, 12, 0, 0, 0, 0, 0)
timestamp = calendar.timegm(t)
print(timestamp)
# 与time.gmtime()对比
print(time.gmtime(timestamp))
6. 应用案例
6.1 生成全年日历并保存到文件
import calendar
def generate_year_calendar(year, filename):
"""生成全年日历并保存到文件"""
with open(filename, 'w', encoding='utf-8') as f:
cal = calendar.calendar(year)
f.write(cal)
print(f"全年日历已保存到{filename}")
# 使用示例
generate_year_calendar(2024, '2024_calendar.txt')
6.2 计算两个日期之间的工作日
import calendar
from datetime import datetime, timedelta
def count_workdays(start_date, end_date):
"""计算两个日期之间的工作日(周一到周五)"""
start = datetime.strptime(start_date, '%Y-%m-%d')
end = datetime.strptime(end_date, '%Y-%m-%d')
if start > end:
start, end = end, start
delta = end - start
workdays = 0
for i in range(delta.days + 1):
day = start + timedelta(days=i)
if day.weekday() < 5: # 0-4表示周一到周五
workdays += 1
return workdays
# 使用示例
print(count_workdays('2023-10-01', '2023-10-31'))
7. 学习路线
- 基础阶段：
- 了解calendar模块的基本功能
- 掌握monthcalendar()、weekday()等基础函数
- 学习如何生成简单的日历
- 进阶阶段：
- 掌握日期计算相关函数
- 学习如何格式化输出日历
- 理解闰年判断和计算
- 应用阶段：
- 实现自定义日历视图
- 开发日历相关的实用工具
- 结合其他模块(如datetime)实现更复杂功能
8. 学习总结
calendar模块是Python中处理日历相关功能的强大工具，它提供了：
- 丰富的日历生成函数
- 灵活的日期计算能力
- 多种格式化输出选项
- 与其他日期时间模块的良好兼容性
通过掌握这个模块，你可以：
- 快速生成各种日历视图
- 实现日期相关的业务逻辑
- 开发日历类应用程序
- 处理复杂的日期计算问题
注意事项：
- 默认每周从周一开始(可通过setfirstweekday()修改)
- 注意函数的返回值类型(有些返回列表，有些返回字符串)
- 考虑时区问题(如果需要处理不同时区的日期)
9. 扩展应用
9.1 结合datetime模块实现更强大的日历功能示例
import calendar
from datetime import datetime, date
def get_month_events(year, month, events_dict):
"""根据事件字典生成带事件的月历"""
cal = calendar.monthcalendar(year, month)
event_cal = []
# 添加月份标题
event_cal.append(f"{calendar.month_name[month]} {year}".center(20))
event_cal.append("Mo Tu We Th Fr Sa Su")
for week in cal:
week_str = ""
for day in week:
if day == 0:
week_str += " "
else:
event_day = date(year, month, day)
events = events_dict.get(event_day, [])
day_str = f"{day:2d}" + ("*" if events else "")
week_str += day_str + " "
event_cal.append(week_str)
# 添加事件标记
if any(events_dict.values()):
event_cal.append("\n事件标记: * 表示有事件")
return "\n".join(event_cal)
# 使用示例
events = {
date(2023, 10, 5): ["会议"],
date(2023, 10, 15): ["生日"],
date(2023, 10, 25): ["截止日期"]
}
print(get_month_events(2023, 10, events))
9.2 实现节假日计算示例
import calendar
from datetime import date
class HolidayCalculator:
"""简单的节假日计算器"""
def __init__(self, year):
self.year = year
self.holidays = self._calculate_holidays()
def _calculate_holidays(self):
"""计算固定节假日"""
holidays = {}
# 元旦
holidays[date(self.year, 1, 1)] = "元旦"
# 春节(简化计算，实际应根据农历计算)
spring_festival = self._calculate_spring_festival()
holidays[spring_festival] = "春节"
# 清明节(4月4日或5日)
qingming = date(self.year, 4, 4)
if calendar.weekday(self.year, 4, 4) == 5: # 如果是周六
qingming = date(self.year, 4, 5)
elif calendar.weekday(self.year, 4, 4) == 6: # 如果是周日
qingming = date(self.year, 4, 6)
holidays[qingming] = "清明节"
# 劳动节
holidays[date(self.year, 5, 1)] = "劳动节"
# 端午节(简化计算)
duanwu = date(self.year, 6, 10) # 实际应根据农历计算
holidays[duanwu] = "端午节"
# 中秋节(简化计算)
mid_autumn = date(self.year, 9, 15) # 实际应根据农历计算
holidays[mid_autumn] = "中秋节"
# 国庆节
holidays[date(self.year, 10, 1)] = "国庆节"
holidays[date(self.year, 10, 2)] = "国庆节"
holidays[date(self.year, 10, 3)] = "国庆节"
return holidays
def _calculate_spring_festival(self):
"""简化计算春节(实际应根据农历计算)"""
# 这里只是示例，实际春节日期需要根据农历计算
# 2023年春节是1月22日
if self.year == 2023:
return date(2023, 1, 22)
# 其他年份可以添加更多数据
return date(self.year, 1, 22) # 默认值
def is_holiday(self, check_date):
"""检查给定日期是否是节假日"""
return check_date in self.holidays
def get_holidays(self):
"""获取所有节假日"""
return self.holidays
# 使用示例
hc = HolidayCalculator(2023)
print("2023年节假日:")
for holiday_date, name in hc.get_holidays().items():
print(f"{holiday_date}: {name}")
check_date = date(2023, 1, 22)
print(f"{check_date}是节假日吗? {hc.is_holiday(check_date)}")
10. 总结
calendar模块是Python标准库中一个非常实用的工具，它提供了丰富的日历相关功能。通过本教程的学习，我们能够：
- 理解calendar模块的基本功能和设计理念
- 掌握各种日历生成和日期计算函数的使用方法
- 实现自定义的日历视图和日期处理工具
- 结合其他模块开发更复杂的日历应用程序
记住，calendar模块虽然功能强大，但对于更复杂的日期时间操作(如时区处理)，可能需要结合datetime和pytz等模块一起使用。
持续更新Python编程学习日志与技巧，敬请关注！
#编程# #学习# #python# #在头条记录我的2025#