如何利用Google Calendar API获取指定重复事件的上一个或下一个具体实例详情

我完全懂你遇到的坑——直接调用events().get()只能拿到重复事件的「母事件」（就是定义重复规则的那个原始事件），根本拿不到具体的上一个或下一个重复实例。而且你还不想靠timeMin/timeMax来硬过滤时间范围，想直接基于给定的母事件ID定位到目标实例对吧？我来给你捋清楚怎么搞定这个问题。

首先得明白Google Calendar的重复事件机制：母事件是负责定义RRULE（重复规则，比如每天/每周几重复）的核心事件，每个实际发生的重复实例都是基于这个母事件生成的独立实体，它们有自己的唯一ID，但你可以通过母事件ID调用instances()方法一次性获取所有实例。

接下来给你两种可行的解决方案，对应不同的场景：

方案一：直接获取预生成的实例（简单可靠，适合近期实例） #

Google Calendar会预先生成未来1年左右的重复实例，用events().instances()就能拿到这些实例，然后我们只需要排序筛选就行，完全不用自己解析复杂的RRULE规则。

我给你修改好你的函数：

from datetime import datetime, timezone

def fetch_event_by_id(service, event_id, future=0, past=0):
    # 先获取母事件详情
    master_event = service.events().get(calendarId="primary", eventId=event_id).execute()
    
    # 如果不需要未来/过去实例，直接返回母事件
    if not future and not past:
        return {"event": master_event, "earlier_events": []}
    
    # 获取该母事件的所有重复实例
    instances = service.events().instances(calendarId="primary", eventId=event_id).execute()
    if not instances:
        # 没有实例，说明这是个单次事件，直接返回母事件
        return {"event": master_event, "earlier_events": []}
    
    # 定义一个函数来统一处理事件的开始时间（兼容全天事件和定时事件）
    def get_utc_start_time(event):
        if 'dateTime' in event['start']:
            # 定时事件，解析带时区的时间字符串
            return datetime.fromisoformat(event['start']['dateTime'].replace('Z', '+00:00'))
        else:
            # 全天事件，把日期转换成UTC零点的datetime
            return datetime.fromisoformat(f"{event['start']['date']}T00:00:00+00:00")
    
    # 把所有实例按开始时间正序排序
    sorted_instances = sorted(instances, key=get_utc_start_time)
    now = datetime.now(timezone.utc)
    
    event_detail = {"event": master_event, "past_events": [], "future_events": []}
    
    # 处理过去的实例需求
    if past > 0:
        # 筛选出所有发生在当前时间之前的实例
        past_instances = [inst for inst in sorted_instances if get_utc_start_time(inst) < now]
        # 取最近的N个过去实例（倒序后取前N个，再正序回来保证时间从早到晚）
        recent_past = reversed(past_instances[-past:]) if past_instances else []
        event_detail["past_events"] = list(recent_past)
    
    # 处理未来的实例需求
    if future > 0:
        # 筛选出所有发生在当前时间之后的实例
        future_instances = [inst for inst in sorted_instances if get_utc_start_time(inst) > now]
        # 取最近的N个未来实例
        event_detail["future_events"] = future_instances[:future]
    
    return event_detail

这段代码的逻辑：

1. 先拿到母事件，确认是重复事件。
2. 调用instances()拉取所有预生成的重复实例。
3. 统一处理定时事件和全天事件的时间格式，避免排序出错。
4. 根据当前时间筛选出过去/未来的实例，再根据你传入的past/future数值取对应数量的实例。
5. 最后把母事件和筛选后的实例一起返回，结构清晰。

方案二：解析RRULE计算实例时间（适合远期实例） #

如果需要获取Google Calendar没预生成的远期实例（比如2年后的重复事件），instances()就拿不到了，这时候需要自己解析母事件的RRULE规则，计算出目标实例的时间，再构造实例ID去获取详情。

举个简单的例子（需要用到python-dateutil库，先装pip install python-dateutil）：

from dateutil.rrule import rrulestr
from datetime import datetime, timezone

def get_utc_start_time(event):
    if 'dateTime' in event['start']:
        return datetime.fromisoformat(event['start']['dateTime'].replace('Z', '+00:00'))
    else:
        return datetime.fromisoformat(f"{event['start']['date']}T00:00:00+00:00")

def get_next_or_prev_instance(service, event_id, is_next=True):
    master_event = service.events().get(calendarId="primary", eventId=event_id).execute()
    if 'recurrence' not in master_event:
        # 不是重复事件，直接返回母事件
        return master_event
    
    # 解析RRULE规则
    rrule_str = master_event['recurrence'][0]
    dtstart = get_utc_start_time(master_event)
    rrule = rrulestr(rrule_str, dtstart=dtstart)
    
    now = datetime.now(timezone.utc)
    # 计算目标实例时间
    if is_next:
        target_time = rrule.after(now)
    else:
        target_time = rrule.before(now)
    
    if not target_time:
        return None  # 没有找到对应实例
    
    # 构造实例ID：母事件ID + "_" + UTC时间的无分隔符格式（比如20240520T100000Z）
    target_time_iso = target_time.strftime("%Y%m%dT%H%M%SZ")
    instance_id = f"{event_id}_{target_time_iso}"
    
    # 获取该实例的详情
    return service.events().get(calendarId="primary", eventId=instance_id).execute()

注意：

这种方法依赖Google Calendar的实例ID格式，虽然长期没怎么变，但还是有微小的变更风险，所以优先用方案一。

为什么你之前的方法不行？ #

你之前直接用events().get()，只能拿到定义重复规则的母事件，而重复实例是独立的实体，必须用instances()方法获取，或者用构造好的实例ID直接get。这就是为什么你之前要么拿到母事件，要么拿不到结果的原因。

备注：内容来源于stack exchange，提问作者Md.Ashiqur Rahman Zayed