当前位置：首页 > Python > 正文

Python calendar模块使用教程 - 完整指南与实例 | Python日期处理

Python calendar模块使用教程

全面指南：从基础日历生成到高级日期操作

Python calendar模块介绍

Python内置的calendar模块提供了多种处理日期和日历的功能。它可以帮助你：

  • 生成各种格式的日历（文本、HTML）
  • 判断某年是否为闰年
  • 计算某月第一天是星期几
  • 获取某个月份的天数范围
  • 处理与日期相关的各种计算

calendar模块是Python标准库的一部分，无需额外安装，是处理日期相关任务的高效工具。

安装与导入

calendar模块是Python标准库的一部分，无需额外安装。只需在代码中导入即可使用：

import calendar

基础日历生成

1. 生成整年日历

使用calendar.calendar()方法生成整年的日历：

import calendar

# 生成2023年日历
year_calendar = calendar.calendar(2023)
print(year_calendar)

2. 生成单月日历

使用calendar.month()方法生成指定年月的日历：

# 生成2023年10月的日历
month_calendar = calendar.month(2023, 10)
print(month_calendar)

# 输出示例：
#     October 2023
# Mo Tu We Th Fr Sa Su
#                    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

3. 生成月份矩阵

使用calendar.monthcalendar()返回表示一个月的矩阵：

# 获取2023年10月的日期矩阵
month_matrix = calendar.monthcalendar(2023, 10)
print(month_matrix)

# 输出：[[0, 0, 0, 0, 0, 0, 1], [2, 3, 4, 5, 6, 7, 8], ...]
# 矩阵中的0表示不属于该月的日期

闰年判断

使用calendar.isleap()判断某年是否为闰年：

# 判断是否为闰年
print(calendar.isleap(2020))  # 输出: True
print(calendar.isleap(2023))  # 输出: False

# 获取两个年份之间的闰年数量
leap_days = calendar.leapdays(2000, 2023)
print(f"2000年到2023年之间的闰年数量: {leap_days}")  # 输出: 6

星期计算

calendar模块提供了多种处理星期的方法：

1. 获取星期几

# 获取2023年10月1日是星期几 (0=星期一, 6=星期日)
weekday = calendar.weekday(2023, 10, 1)
print(weekday)  # 输出: 6 (星期日)

# 获取月份第一天是星期几
first_weekday = calendar.monthrange(2023, 10)[0]
print(f"2023年10月的第一天是星期: {first_weekday}")  # 0=星期一

2. 获取星期名称

# 获取星期名称的缩写
abbr_days = calendar.weekheader(3)
print(abbr_days)  # 输出: Mon Tue Wed Thu Fri Sat Sun

# 获取完整的星期名称
full_days = calendar.day_name
print(full_days)  # 输出: ('Monday', 'Tuesday', ...)

获取月份天数范围

使用calendar.monthrange()获取月份的天数和第一天是星期几：

# 获取2023年2月的信息 (非闰年)
first_weekday, num_days = calendar.monthrange(2023, 2)
print(f"第一天是星期: {first_weekday}")  # 输出: 2 (星期三)
print(f"当月天数: {num_days}")         # 输出: 28

# 获取2024年2月的信息 (闰年)
first_weekday, num_days = calendar.monthrange(2024, 2)
print(f"第一天是星期: {first_weekday}")  # 输出: 3 (星期四)
print(f"当月天数: {num_days}")         # 输出: 29

使用TextCalendar类

TextCalendar类提供了更灵活的文本日历生成功能：

# 创建TextCalendar实例 (默认从周一开始)
tc = calendar.TextCalendar(calendar.MONDAY)

# 生成2023年10月的日历
october_cal = tc.formatmonth(2023, 10)
print(october_cal)

# 生成整年日历
year_cal = tc.formatyear(2023, m=4)  # m=4 表示每行4个月
print(year_cal)

生成HTML日历

HTMLCalendar类可以生成HTML格式的日历：

# 创建HTMLCalendar实例
hc = calendar.HTMLCalendar(calendar.SUNDAY)

# 生成2023年10月的HTML日历
october_html = hc.formatmonth(2023, 10)
print(october_html)

# 生成整年HTML日历
year_html = hc.formatyear(2023, width=3)  # width=3 表示每行3个月
print(year_html)

生成的HTML可以直接嵌入网页使用，并可通过CSS自定义样式。

高级应用

1. 自定义日历格式

# 创建自定义TextCalendar类
class CustomCalendar(calendar.TextCalendar):
    def formatday(self, day, weekday, width):
        if day == 0:
            return ' ' * width
        if day == 15:  # 特殊标记某一天
            return f'[{day:2d}]'
        return f'{day:2d}'.center(width)

tc = CustomCalendar()
print(tc.formatmonth(2023, 10))

2. 计算日期相关事件

# 计算2023年感恩节 (11月第四个星期四)
def get_thanksgiving(year):
    november = calendar.monthcalendar(year, 11)
    # 第四个星期四
    if november[0][calendar.THURSDAY] != 0:
        thanksgiving = november[3][calendar.THURSDAY]
    else:
        thanksgiving = november[4][calendar.THURSDAY]
    return thanksgiving

thanksgiving_2023 = get_thanksgiving(2023)
print(f"2023年感恩节是11月{thanksgiving_2023}日")

总结

Python的calendar模块是一个功能强大且易于使用的工具，适用于各种日历相关任务。从简单的日历生成到复杂的日期计算，这个模块都能高效地完成任务。通过本教程，您已经学习了calendar模块的核心功能，现在可以在您的项目中应用这些知识了！

开始使用Python calendar模块提升您的日期处理能力吧！
本文由HouNei于2025-07-25发表在吾爱品聚，如有疑问，请联系我们。
本文链接：https://521pj.cn/20256468.html

相关文章

发表评论