如何使用Python calendar模块快速生成指定年份的节假日清单？-Python教程-PHP中文网

calendar模块不包含节假日数据，仅提供日历结构计算功能；它无法识别国庆节、春节等法定假日，也不支持农历转换，必须依赖holidays等第三方库加载节假日规则。

如何使用python calendar模块快速生成指定年份的节假日清单？

calendar 模块本身不包含节假日数据，它只能生成日历结构；要生成真实节假日清单，必须额外引入节假日规则或第三方库。

为什么直接用 `calendar` 模块得不到节假日？

calendar 是纯日历工具：它能告诉你某年某月 1 号是星期几、某月有多少天、是否闰年，但完全不知道“国庆节是 10 月 1 日”或“春节按农历算”。它没有内置任何国家/地区节假日逻辑，也不联网查数据。

常见误解是调用 calendar.monthcalendar() 或 calendar.itermonthdays2() 后标出“周末”，就以为完成了节假日 —— 实际上周末 ≠ 节假日（比如调休上班日），法定假日也远不止周末。

周末只是 calendar.weekday() 返回值为 5 或 6 的日期
法定节假日需人工定义或从外部源加载（如 JSON、API、holidays 库）
中国春节、端午等依赖农历，calendar 不提供农历转换能力

用 `holidays` 库 + `calendar` 协同生成真实节假日清单

推荐组合：holidays（提供各国法定假日计算逻辑）负责识别节日日期，calendar 负责组织成月视图或遍历全年。安装命令：

Python数据分析(免费版)

提供Python数据清洗、统计分析与可视化建议，覆盖业务报表与科研数据的快速处理流程。

下载

pip install holidays

以中国 2024 年为例：

import holidays
import calendar
<p>cn_holidays = holidays.China(years=2024)
cal = calendar.Calendar()</p><h1>获取 2024 全年所有节假日（含调休工作日）</h1><p>all_holidays = sorted(cn_holidays.keys())</p><h1>若只要放假的日期（排除调休上班日），需结合 holiday 名称判断，例如：</h1><h1>cn_holidays.get('2024-02-10') → 'Spring Festival'，而 '2024-02-17' 可能返回 'Working Day'</h1><h1>所以更稳妥的方式是过滤掉含 'Working Day' 的条目</h1><p>actual_holidays = [
date for date in all_holidays
if 'Working Day' not in str(cn_holidays.get(date))
]</p>

holidays.China() 支持自动处理调休、春节浮动日期、2024 年新增假期等
cn_holidays.get(date) 返回节日名称字符串，可据此区分真实放假日和调休日
不要依赖 holidays 的 get_list() 直接输出——它可能包含非放假日，需二次过滤

用 `calendar` 辅助格式化输出（按月分组、标记周末）

有了节假日日期列表后，可用 calendar 做排版增强，比如生成带标注的文本月历：

year = 2024
for month in range(1, 13):
    print(f'\n{year}年{month}月')
    # 获取该月所有日期及 weekday（0=Mon）
    for day, weekday in calendar.Calendar().itermonthdays2(year, month):
        if day == 0:
            continue
        date_str = f'{year}-{month:02d}-{day:02d}'
        is_holiday = date_str in actual_holidays
        is_weekend = weekday in (5, 6)
        marker = '●' if is_holiday else '○' if is_weekend else ' '
        print(f'{day:2d}{marker}', end=' ')
    print()