知识导图

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. 学习路线

1. 基础阶段：
2. 了解calendar模块的基本功能
3. 掌握monthcalendar()、weekday()等基础函数
4. 学习如何生成简单的日历
5. 进阶阶段：
6. 掌握日期计算相关函数
7. 学习如何格式化输出日历
8. 理解闰年判断和计算
9. 应用阶段：
10. 实现自定义日历视图
11. 开发日历相关的实用工具
12. 结合其他模块(如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标准库中一个非常实用的工具，它提供了丰富的日历相关功能。通过本教程的学习，我们能够：

1. 理解calendar模块的基本功能和设计理念
2. 掌握各种日历生成和日期计算函数的使用方法
3. 实现自定义的日历视图和日期处理工具
4. 结合其他模块开发更复杂的日历应用程序

记住，calendar模块虽然功能强大，但对于更复杂的日期时间操作(如时区处理)，可能需要结合datetime和pytz等模块一起使用。

持续更新Python编程学习日志与技巧，敬请关注！

#编程# #学习# #python# #在头条记录我的2025#