Python OOP实现带事件日历：如何将事件关联至指定日期？

问题背景 #

我是Python新手，但有扎实的Java OOP基础，正在尝试用Python实现一个带事件功能的日历，要求不导入任何包且用面向对象编程。目前我的代码已经能正常显示年度日历，但不知道如何将事件分配到特定日期。

现有代码如下：

class Calendar:
    def __init__(self, year):
        self.year = year
        months = [('Jan'), range(1, 32), ... ('Dec', range(1, 32)) ]
        days = ['Mon','Tue','Wed','Thu','Fri','Sat','Sun']
    def isLeapYear():
        <<判断闰年的代码>>
class CalendarView(Calendar):
    def __init__(self, year):
        self.year = year
    def buildYearlyCalendar(self, startDay):
        <<展示日历的代码>>

我已经能正常显示年度日历，后续会优化成可指定月份打印。现在需要实现添加事件并分配时间范围的功能，不确定是否需要导入时间包，但必须遵循OOP概念。

我写的Event类目前是这样的：

class Event(Calendar):
    def __init__(self, day, month, year, time, Event):
        self.day = day
        self.month = month
        self.year = year
        self.Event = Event
    def addEvent(self, day, month, year, time, Event):
        <<尚未完成的代码>>

在Java里这类似把对象分配给更具体的对象，但我不清楚Python里怎么实现。我应该把事件设为元组吗？还是有其他更好的方法？

解决方案建议 #

首先要纠正一个OOP设计上的问题：Event不应该继承Calendar。在OOP中，继承代表的是"is-a"关系，而事件并不是一种日历，应该是"has-a"关系——日历拥有多个事件。

1. 重构Event类 #

先把Event改成一个独立的实体类，用来封装事件的所有属性：

class Event:
    def __init__(self, day, month, year, time, description):
        # 可以在这里添加日期合法性检查（比如判断月份1-12，天数对应月份的最大天数）
        self.day = day
        self.month = month
        self.year = year
        self.time = time  # 用字符串格式比如"14:30"即可，无需导入包
        self.description = description  # 把原参数名"Event"改成更清晰的描述名

    def __str__(self):
        # 方便直接打印事件信息
        return f"{self.year}-{self.month}-{self.day} {self.time}: {self.description}"

2. 在Calendar类中存储事件 #

在Calendar类里添加一个字典来存储事件，键用(year, month, day)这样的元组，值是该日期对应的事件列表，这样能高效查找指定日期的事件：

class Calendar:
    def __init__(self, year):
        self.year = year
        # 修复months定义：每个元素存月份名称和对应天数，同时考虑闰年
        self.months = [
            ("Jan", 31), ("Feb", 28 if not self.is_leap_year() else 29),
            ("Mar", 31), ("Apr", 30), ("May", 31), ("Jun", 30),
            ("Jul", 31), ("Aug", 31), ("Sep", 30), ("Oct", 31),
            ("Nov", 30), ("Dec", 31)
        ]
        self.days_of_week = ['Mon','Tue','Wed','Thu','Fri','Sat','Sun']
        # 存储事件的字典：键是日期元组，值是Event对象列表
        self.events = {}

    def is_leap_year(self):
        # 实现闰年判断，注意方法要传入self参数
        if self.year % 4 != 0:
            return False
        elif self.year % 100 != 0:
            return True
        else:
            return self.year % 400 == 0

    def add_event(self, event):
        # 检查事件年份是否和日历年份匹配（如果你的日历是单年度的）
        if event.year != self.year:
            raise ValueError("Event year does not match calendar year")
        # 检查日期是否合法
        month_name, max_day = self.months[event.month - 1]
        if event.day < 1 or event.day > max_day:
            raise ValueError(f"Invalid day for {month_name}: {event.day}")
        # 构建日期键并添加事件
        date_key = (event.year, event.month, event.day)
        if date_key not in self.events:
            self.events[date_key] = []
        self.events[date_key].append(event)

    def get_events(self, day, month):
        # 获取指定日期的所有事件，没有则返回空列表
        date_key = (self.year, month, day)
        return self.events.get(date_key, [])

3. 在CalendarView中展示事件 #

修改buildYearlyCalendar方法，在打印日期时同步展示该日期的事件：

class CalendarView(Calendar):
    def __init__(self, year):
        super().__init__(year)  # 调用父类构造方法，避免重复赋值self.year

    def buildYearlyCalendar(self, start_day):
        # 假设你原有代码是逐月份打印日历
        for month_idx, (month_name, max_day) in enumerate(self.months):
            month = month_idx + 1
            print(f"\n===== {month_name} {self.year} =====")
            print(" ".join(self.days_of_week))
            
            # 这里放你原有计算月历排版、打印日期的代码
            # ...
            
            # 当打印到某个日期day时，获取并打印事件
            events = self.get_events(day, month)
            if events:
                print(f"  当日事件:")
                for event in events:
                    print(f"    - {event}")

4. 使用示例 #

# 创建2024年日历
my_calendar = CalendarView(2024)
# 创建一个事件
birthday = Event(15, 5, 2024, "18:00", "Alice's Birthday Party")
# 添加事件到日历
my_calendar.add_event(birthday)
# 打印年度日历（会包含事件信息）
my_calendar.buildYearlyCalendar(start_day=1)  # 假设2024年1月1日是周一

关键思路说明 #

• 纠正继承关系：用组合（Calendar包含Event列表）代替错误的继承，更符合OOP的"has-a"关联逻辑。
• 高效事件存储：用日期元组作为字典键，能快速定位指定日期的事件，比遍历所有事件效率高得多。
• 合法性校验：在添加事件时做日期合法性检查，避免无效事件被存入。
• 符合Python规范：调整方法名（比如isLeapYear改为is_leap_year）和参数名，提升代码可读性。

内容的提问来源于stack exchange，提问作者Xhuliano98