Python调用Google Calendar API仅返回当日及之前事件，如何获取未来事件？

你遇到的问题核心是调用events.list时没有指定时间范围过滤条件——默认情况下API可能会返回包含过去事件的结果，甚至优先展示近期的历史事件。要获取即将发生的未来事件，只需要添加timeMin参数，把查询的起始时间设为当前UTC时间即可。

修改后的代码示例 #

先导入datetime模块生成符合API要求的时间格式，再在调用中加入关键的过滤参数：

from datetime import datetime
from flask import jsonify

@app.route('/events',methods=['GET'])
def getEvents():
    # 生成当前UTC时间的RFC3339格式字符串（Google API强制要求的格式）
    current_utc_time = datetime.utcnow().isoformat() + 'Z'  # 'Z'标记代表UTC时区
    
    eventsResult = service.events().list(
        calendarId='primary',
        maxResults=18,
        singleEvents=True,
        orderBy='startTime',
        timeMin=current_utc_time  # 核心参数：只返回开始时间晚于等于当前时间的事件
    ).execute()
    
    print("HERE")
    if not eventsResult:
        return "NONE"
    events = eventsResult.get('items', [])
    print("##[EVENTS]##:\n",eventsResult)
    
    if not events:
        return jsonify({'status':'There are no upcoming events present'}),204
    
    # 可选：遍历事件处理时间格式或其他逻辑
    for event in events:
        start = event['start'].get('dateTime', event['start'].get('date'))
        # 这里可以添加时间转换、格式化等操作，比如把UTC时间转成本地时间
    
    return jsonify(events),200

关键参数说明 #

• timeMin：指定查询的起始时间，格式必须严格遵循RFC3339标准（例如2024-05-20T12:00:00Z）。用当前UTC时间作为起始点，就能确保只返回从现在开始的未来事件。
• 如果想限定查询的时间范围（比如接下来7天的事件），可以额外添加timeMax参数：

  from datetime import timedelta
  future_utc_time = (datetime.utcnow() + timedelta(days=7)).isoformat() + 'Z'
  # 然后在list方法中加入 timeMax=future_utc_time
  

• 你原本设置的singleEvents=True和orderBy='startTime'是正确的：前者会把重复事件展开为单个独立事件，后者会按事件开始时间排序，方便查看未来事件的先后顺序。

注意事项 #

• 确保你的API权限配置正确，拥有读取日历数据的权限（通常是https://www.googleapis.com/auth/calendar.readonly）。
• 时间格式必须带Z后缀表示UTC时间，避免时区差异导致过滤结果不准确。

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