使用Google Calendar API无法检索单日时段事件问题

核心问题是查询时间范围的边界设置错误，导致带具体起止时间的时段事件不在检索范围内：

• 全天事件的时间字段是date，API会自动匹配整个日期范围；
• 时段事件的时间字段是dateTime，如果仅将timeMin和timeMax设为同一天的00:00，相当于查询范围为空（从当天0点到当天0点），自然无法匹配到任何时段事件。

修正后的查询逻辑 #

正确的做法是将查询的结束时间设为目标日期的次日00:00，同时指定时区避免偏移问题。以下是Python示例代码：

from datetime import datetime, timedelta
from googleapiclient.discovery import build

# 初始化Calendar服务（省略认证步骤）
service = build('calendar', 'v3', credentials=creds)

# 指定要查询的目标日期
target_date = datetime(2024, 5, 20)

# 设置时间范围：目标日期00:00 到 次日00:00
start_time = target_date.replace(hour=0, minute=0, second=0).isoformat() + 'Z'
end_time = (target_date + timedelta(days=1)).replace(hour=0, minute=0, second=0).isoformat() + 'Z'

# 执行事件查询
events_result = service.events().list(
    calendarId='你的日历ID',
    timeMin=start_time,
    timeMax=end_time,
    singleEvents=True,
    orderBy='startTime',
    timeZone='Asia/Shanghai'  # 替换为你实际使用的时区
).execute()

events = events_result.get('items', [])

关键注意事项 #

• 时间范围必须覆盖目标日期的全部24小时，即从当天0点到次日0点，才能包含所有时段事件。
• 务必指定timeZone参数，否则API会默认使用UTC时区，可能导致时区偏移下的事件被排除。
• singleEvents=True会展开重复事件为单个实例，避免遗漏重复的时段事件。

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