重复事件RRULE中UNTIL字段日期时区及API参数影响问询

核心问题解答 #

1. DATE格式的UNTIL属于UTC还是本地时间？ #

当RRULE的UNTIL字段为DATE格式（如UNTIL=20241103）时，它对应的是该事件所属日历的本地时区日期，并非UTC时间。这符合RFC5545标准的定义：DATE类型的时间组件默认关联“本地时间”，此处的本地时间以日历本身的时区设置为准。

2. 调用events/get接口指定timezone参数是否会影响DATE格式的UNTIL？ #

不会。timezone参数仅影响事件的start、end等时间字段的显示时区，不会修改RRULE中DATE格式的UNTIL值。该字段始终与日历原始时区绑定，不受请求时区参数的干扰。

3. 返回的RRULE中UNTIL的本地日期基于日历时区还是请求时区？ #

基于事件所属的日历时区，和请求时指定的timezone参数无关。RRULE的重复规则与日历的时区设置绑定，不会随请求时区变化而改变。

测试与生产环境的格式差异说明 #

生产环境出现DATE格式UNTIL，而测试环境始终返回UTC格式DATE-TIME（如UNTIL=20241103T235959Z），以及全天事件未返回DATE格式的情况，主要和以下因素有关：

• 事件创建方式：通过Google日历界面创建的全天重复事件，更大概率返回DATE格式的UNTIL；而通过API创建事件时，如果传入的是DATE-TIME格式的时间（即使是全天事件），API可能会保留DATE-TIME格式返回。
• 日历配置差异：生产环境的日历可能存在用户手动调整的时区或事件属性，而测试环境的日历多为批量创建的标准化配置，导致返回格式不同。
• API返回逻辑：Google日历API允许RFC5545规定的两种UNTIL格式，会根据事件类型（全天/非全天）、创建来源自动选择返回格式，没有绝对强制的返回规则，因此测试与生产的差异属于正常现象。

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