使用Java调用Google Calendar API处理DST：事件时间自动偏移问题

问题原因 #

你遇到的核心问题是：通过API创建的时区感知事件会遵循目标时区的夏令时规则自动调整UTC偏移，导致本地时间显示变化；而CSV上传的是浮动时间事件（无时区关联的固定本地时分），因此不会受DST影响。

正确实现方式 #

要通过API创建固定本地时间、不受DST影响的事件，需要构造无时区关联的浮动时间事件，具体步骤如下：

1. 构造EventDateTime时，仅设置不带UTC偏移的本地时间字符串，不设置timeZone属性
2. 确保你的日历默认时区为目标时区（如Europe/Berlin），Google Calendar会自动将浮动时间解析为该时区的固定本地时间

修改后的代码示例 #

static void dstUploadProbe(){
    //Initiate helper class to create OAuth2 token and get Calendar service
    CalendarHelper calendarHelper = new CalendarHelper();
    calendarHelper.initService();

    Event event = new Event();
    // 仅传递不带偏移的本地时间，不设置时区
    DateTime startDateTime = new DateTime("2022-10-30T18:00:00");
    EventDateTime startEventDateTime = new EventDateTime();
    startEventDateTime.setDateTime(startDateTime);
    // 不要调用setTimeZone方法

    // 结束时间同理
    DateTime endDateTime = new DateTime("2022-10-30T20:30:00");
    EventDateTime endEventDateTime = new EventDateTime();
    endEventDateTime.setDateTime(endDateTime);
    // 不要调用setTimeZone方法

    // 创建事件
    event.setSummary("Fixed Time Meeting (No DST Adjustment)");
    event.setStart(startEventDateTime);
    event.setEnd(endEventDateTime);

    // 上传事件
    try {
        CalendarHelper.addEvent(calendarHelper.service, calendarHelper.currentCalendarId, event);
    } catch (IOException ex) {
        throw new RuntimeException(ex);
    }
}

为什么之前的方式失败 #

• 方式1：同时设置timeZone和带偏移的dateTime，Google会将其识别为时区感知事件，自动应用DST规则调整偏移，导致本地时间变化
• 方式2：设置了timeZone，即使dateTime不带偏移，Google也会将其解析为该时区的时区感知时间，遵循DST规则
• 方式3：可能你的DateTime构造函数默认使用了JVM时区，或API客户端自动注入了时区信息，导致事件被识别为时区感知事件

注意事项 #

• 若需在不同时区查看时仍显示固定本地时间，需确保日历默认时区为目标时区
• 浮动时间事件不会随DST调整，但如果修改日历时区，事件的本地时间显示会随之变化

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