在 Python 开发中，我们经常需要处理日期和时间。虽然 datetime 库是最常用的选择，但其实 Python 标准库中的 calendar 模块也是一个强大的工具，特别适合处理日历相关的计算和展示。
从一个真实场景开始
假设你正在开发一个会议室预订系统，需要：
- 展示月度视图
- 计算工作日
- 处理节假日逻辑
让我们看看如何用 calendar 来优雅地解决这些问题。
基础用法：生成日历
import calendar
# 创建日历对象
c = calendar.TextCalendar()
# 生成 2024 年 1 月的日历
print(c.formatmonth(2024, 1))这会生成一个格式化的月历：
January 2024
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高级应用：自定义工作日历
import calendar
from datetime import date, timedelta
class BusinessCalendar(calendar.Calendar):
def __init__(self, holidays=None):
super().__init__()
self.holidays = holidays or set()
def get_working_days(self, year, month):
"""获取指定月份的工作日"""
working_days = []
for day in self.itermonthdays2(year, month):
# day[0] 是日期，day[1] 是星期（0-6，0是周一）
if day[0] > 0: # 排除填充日期
current_date = date(year, month, day[0])
# 周末或节假日跳过
if day[1] < 5 and current_date not in self.holidays:
working_days.append(current_date)
return working_days
# 使用示例
holidays = {date(2024, 1, 1), date(2024, 2, 10)} # 元旦和春节
bc = BusinessCalendar(holidays)
working_days = bc.get_working_days(2024, 1)
print(f"2024年1月工作日数量：{len(working_days)}")实用技巧：判断特定日期
import calendar
from datetime import date, timedelta
def is_last_day_of_month(date_obj):
"""判断是否是当月最后一天"""
return date_obj.day == calendar.monthrange(date_obj.year, date_obj.month)[1]
def get_next_weekday(date_obj, weekday):
"""获取下一个指定星期几的日期"""
days_ahead = weekday - date_obj.weekday()
if days_ahead <= 0:
days_ahead += 7
return date_obj + timedelta(days=days_ahead)
# 使用示例
today = date.today()
print(f"今天是否月末：{is_last_day_of_month(today)}")
next_monday = get_next_weekday(today, calendar.MONDAY)
print(f"下个星期一是：{next_monday}")命令行中的日历魔法：calendar 命令行工具
Python 作为一款“脚本语言”，自然 calendar 模块不仅可以在代码中使用，还可以直接在命令行中当作工具来使用。
基础用法
最简单的用法是直接显示当年日历：
python -m calendar
...
October November December
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
1 2 3 4 5 6 1 2 3 1
7 8 9 10 11 12 13 4 5 6 7 8 9 10 2 3 4 5 6 7 8
14 15 16 17 18 19 20 11 12 13 14 15 16 17 9 10 11 12 13 14 15
21 22 23 24 25 26 27 18 19 20 21 22 23 24 16 17 18 19 20 21 22
28 29 30 31 25 26 27 28 29 30 23 24 25 26 27 28 29
30 31显示指定年份的日历：
python -m calendar 2024显示指定年月的日历：
python -m calendar 2024 1 # 显示 2024 年 1 月
January 2024
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实用技巧
将日历保存到文件：
python -m calendar 2024 > calendar_2024.txt配合其他命令使用：
# 显示特定月份并高亮今天的日期（使用 grep）
python -m calendar | grep -C 6 "$(date '+%-d')"小贴士
在 Unix/Linux 系统中，你可以为常用的日历命令创建别名：
alias mycal='python -m calendar'配合 grep 使用可以快速查找特定日期：
python -m calendar 2024 | grep -A 7 "January" # 显示 2024 年 1 月命令行工具的优势在于快速查看和简单的日期计算，特别适合在以下场景中使用：
- 快速查看日期安排
- 在终端中进行日期核对
- 编写 shell 脚本时需要日历功能
- 需要生成纯文本格式的日历报告
通过命令行使用 calendar 模块，我们可以快速获取所需的日历信息，这对于经常使用命令行的开发者来说是一个非常实用的工具。
实践建议
- 使用 calendar 处理日历展示和计算时，优先考虑继承 Calendar 类来扩展功能
- 对于重复性的日期计算，可以创建自定义的日历类
- 结合 datetime 和 calendar 使用，能够处理更复杂的时间计算场景
总结
Python 的 calendar 模块虽然看起来简单，但实际上非常实用。它不仅可以生成漂亮的日历，还能帮助我们处理各种日期计算问题。特别是在处理工作日、假期这类业务场景时，calendar 模块的优势就非常明显了。
建议大家在实际开发中多尝试使用 calendar 模块，它可以让你的代码更加 Pythonic，也更容易维护。
