日历事件重叠检测：核心逻辑与编程实践

from datetime import datetime

class Event:
    """
    表示一个日历事件，采用半开区间 [start, end)
    """
    def __init__(self, name: str, start: datetime, end: datetime):
        if not isinstance(start, datetime) or not isinstance(end, datetime):
            raise TypeError("Start and end times must be datetime objects.")
        if start >= end:
            raise ValueError("Event start time must be strictly before end time.")

        self.name = name
        self.start = start
        self.end = end

    def __repr__(self):
        return f"Event('{self.name}', {self.start.strftime('%Y-%m-%d %H:%M')}, {self.end.strftime('%Y-%m-%d %H:%M')})"

    def __str__(self):
        return f"{self.name} ({self.start.strftime('%H:%M')} - {self.end.strftime('%H:%M')})"

def do_events_overlap(event1: Event, event2: Event) -> bool:
    """
    判断两个事件是否重叠。
    假设事件区间为半开区间 [start, end) (包含开始时间，不包含结束时间)。

    参数:
    event1 (Event): 第一个事件对象。
    event2 (Event): 第二个事件对象。

    返回:
    bool: 如果两个事件重叠则返回 True，否则返回 False。
    """
    # 检查 event1 的开始时间是否在 event2 的结束时间之前
    # 并且 event2 的开始时间是否在 event1 的结束时间之前
    # 如果两个条件都满足，则重叠。
    return event1.start < event2.end and event2.start < event1.end

# --- 示例用法 ---
if __name__ == "__main__":
    # 定义一些示例事件
    # 日期部分可以相同，主要关注时间部分
    today = datetime(2023, 10, 26)

    event_a = Event("会议A", today.replace(hour=9, minute=0), today.replace(hour=10, minute=0)) # 09:00 - 10:00
    event_b = Event("午餐", today.replace(hour=9, minute=30), today.replace(hour=10, minute=30)) # 09:30 - 10:30
    event_c = Event("项目评审", today.replace(hour=11, minute=0), today.replace(hour=12, minute=0)) # 11:00 - 12:00
    event_d = Event("全天会议", today.replace(hour=8, minute=0), today.replace(hour=17, minute=0)) # 08:00 - 17:00 (包含A, B, C)
    event_e = Event("短暂交接", today.replace(hour=10, minute=0), today.replace(hour=10, minute=30