Python calendar模块方法有哪些

# Python calendar模块方法详解

## 目录
1. [calendar模块概述](#calendar模块概述)
2. [常用类与方法](#常用类与方法)
   - [TextCalendar类](#textcalendar类)
   - [HTMLCalendar类](#htmlcalendar类)
   - [Calendar类](#calendar类)
3. [核心功能方法](#核心功能方法)
   - [月份/年历生成](#月份年历生成)
   - [日期计算](#日期计算)
   - [闰年判断](#闰年判断)
4. [实用示例](#实用示例)
5. [总结](#总结)

## calendar模块概述

Python标准库中的`calendar`模块提供了与日历相关的各种功能，包括：
- 生成各种格式的日历（文本/HTML）
- 计算特定月份的天数
- 判断闰年
- 获取星期几等信息
- 日期迭代处理

该模块无需安装，直接通过`import calendar`即可使用。

```python
import calendar

常用类与方法

TextCalendar类

生成纯文本日历的主要类：

参数说明： - w：日期列宽（默认0） - l：每周行数（默认0） - c：月份间隔（默认6） - m：每行显示月份数（默认3）

HTMLCalendar类

生成HTML格式日历的类：

Calendar类

基础日历类，提供核心计算方法：

cal = calendar.Calendar(firstweekday=0)  # 设置周起始日（0=周一）

核心功能方法

月份/年历生成

1. month(theyear, themonth, w=0, l=0)

   print(calendar.month(2023, 9))
   # 输出：
   #   September 2023
   # Mo Tu We Th Fr Sa Su
   #              1  2  3
   #  4  5  6  7  8  9 10
   # ...
   

2. monthcalendar(theyear, themonth) 返回代表月份的二维列表，每周为子列表：

   calendar.monthcalendar(2023, 9)
   # [[0, 0, 0, 0, 1, 2, 3], 
   #  [4, 5, 6, 7, 8, 9, 10], ...]
   

3. monthrange(year, month) 返回月份第一天的星期和天数：

   calendar.monthrange(2023, 9)  # (4, 30) 表示9月1日是周五，共30天
   

日期计算

1. weekday(year, month, day) 返回日期对应的星期（0-6对应周一到周日）

   calendar.weekday(2023, 9, 1)  # 4（周五）
   

2. monthlen(year, month)（Python 3.10+） 直接返回月份天数：

   calendar.monthlen(2023, 2)  # 28
   

3. day_name, day_abbr, month_name, month_abbr 本地化的星期/月份名称：

   list(calendar.day_name)  # ['Monday', 'Tuesday', ...]
   

闰年判断

1. isleap(year) 判断是否为闰年：

   calendar.isleap(2024)  # True
   

2. leapdays(y1, y2) 计算两个年份间的闰年数：

   calendar.leapdays(2000, 2020)  # 5
   

实用示例

示例1：生成带标记的日历

import calendar
from datetime import date

class MarkedCalendar(calendar.TextCalendar):
    def __init__(self, marks=None, firstweekday=0):
        super().__init__(firstweekday)
        self.marks = marks or {}
    
    def formatday(self, day, weekday, width):
        if day == 0:
            return super().formatday(day, weekday, width)
        if day in self.marks:
            return f"{day:2d}*".center(width)
        return super().formatday(day, weekday, width)

# 使用示例
marks = {15: "会议", 20: "生日"}
mc = MarkedCalendar(marks=marks.keys())
print(mc.formatmonth(2023, 9))

示例2：生成iCalendar文件

def generate_ical(year, month, events):
    ical = "BEGIN:VCALENDAR\nVERSION:2.0\n"
    for day, summary in events.items():
        dt = f"{year}{month:02d}{day:02d}"
        ical += f"""BEGIN:VEVENT
DTSTART;VALUE=DATE:{dt}
SUMMARY:{summary}
END:VEVENT\n"""
    ical += "END:VCALENDAR"
    return ical

events = {1: "开学日", 10: "教师节"}
print(generate_ical(2023, 9, events))

示例3：节假日计算

def get_holidays(year, country='CN'):
    holidays = {}
    if country == 'CN':
        # 春节计算（简化版）
        spring_festival = calendar.CNSpringFestival(year)
        holidays[spring_festival] = "春节"
        # 国庆节
        holidays[date(year, 10, 1)] = "国庆节"
    return holidays

总结

calendar模块的主要优势包括：

1. 功能全面：覆盖了大部分日历相关计算需求
2. 灵活输出：支持文本、HTML等多种格式
3. 国际化支持：通过locale模块可本地化显示
4. 扩展性强：可通过继承基础类实现自定义日历

实际应用场景： - 生成报表中的日期信息 - 开发日程管理应用 - 创建自定义日历视图 - 节假日计算系统

通过合理使用calendar模块，可以显著减少日期相关计算的开发工作量，建议开发者熟练掌握其核心API。

注意：本文示例基于Python 3.8+版本，部分新特性可能需要更高版本支持。 “`

这篇文章共计约3150字，采用Markdown格式编写，包含： 1. 多级标题结构 2. 代码块示例 3. 表格展示方法参数 4. 实际应用案例 5. 模块化内容组织

可根据需要进一步扩展具体示例或添加性能优化建议等内容。