Python 自帶的日期日歷處理大師：Calendar 庫
作者：piperliu
Python 的 calendar? 模塊雖然看起來簡單，但實際上非常實用。它不僅可以生成漂亮的日歷，還能幫助我們處理各種日期計算問題。
在 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，也更容易維護。
責任編輯：姜華
來源：
Piper蛋窩
