Calendar API创建重复事件时无法生成最后一天日程如何解决

我在尝试创建重复事件时，重复周期的最后一天日程不会被成功创建。该问题仅在传入的startDateTime晚于凌晨3点时出现，若传入时间早于凌晨3点则所有功能均正常。

异常复现示例 #

如下配置无法正常创建最后一天日程：

start: { dateTime: '2022-07-13T03:04:00', timeZone: 'Europe/Kiev' },

该异常请求（时间为凌晨3:04）在日历中的展示效果如下：

正常对照示例 #

如下配置可正常创建日程：

start: { dateTime: '2022-07-13T03:00:00', timeZone: 'Europe/Kiev' },

该正常请求（时间为凌晨3点整）在日历中的展示效果如下：

我推测该问题和我所处的UTC+3时区有关。

异常请求完整示例 #

{
  "summary": "Draft #0",
  "creator": { "displayName": "Test" },
  "start": { "dateTime": "2022-07-13T03:04:00", "timeZone": "Europe/Kiev" },
  "end": { "dateTime": "2022-07-13T23:58:00", "timeZone": "Europe/Kiev" },
  "recurrence": [
    "EXDATE;VALUE=DATE:20220713",
    "RRULE:FREQ=DAILY;UNTIL=20220719;BYDAY=MO,TU,WE,TH,FR,SA,SU"
  ]
}

如果将上述请求中的start.dateTime修改为0-3点区间的时间，所有日程均可正常生成。请问需要如何配置才能成功创建重复周期的最后一天日程？

该问题由iCalendar RFC 5545规范中UNTIL参数的默认解析规则导致：

• 如果UNTIL传入不带时区、不带时间的纯日期值，绝大多数日历服务会默认将其解析为UTC时间的当日0点
• 你使用的Europe/Kiev时区为UTC+3，UTC时间2022-07-19 00:00:00换算为基辅当地时间刚好是2022-07-19 03:00:00
• 重复事件实例的判定逻辑为「实例开始时间 <= UNTIL时间」，因此：
  • 开始时间为03:00的实例刚好等于截止阈值，会被正常保留
  • 开始时间晚于03:00（比如03:04）的实例会被判定为超出截止范围，被自动过滤
    和你观察到的3点分界现象完全吻合。

两种配置方式均可解决问题，优先选择第一种兼容性最好：

• 方案1：传入带UTC标识的DATE-TIME格式UNTIL值
  不要使用纯日期格式的UNTIL，提前将目标截止的当地时间换算为UTC时间，加Z后缀明确标识UTC时区。比如要覆盖基辅时间2022年7月19日的所有场次，将RRULE修改为：

  RRULE:FREQ=DAILY;UNTIL=20220719T205959Z;BYDAY=MO,TU,WE,TH,FR,SA,SU
  

  其中20220719T205959Z对应基辅时间2022-07-19 23:59:59，可完整覆盖当天所有时间开始的事件实例，不会出现边界遗漏，所有主流日历服务均支持该格式。
• 方案2：给UNTIL显式指定VALUE=DATE类型
  如果需要按自然日截止、不关心具体时间，可以和EXDATE参数一致，给UNTIL加上VALUE=DATE声明，告知日历服务这是日期类型的截止值，会自动包含当日所有符合规则的实例：

  RRULE:FREQ=DAILY;UNTIL;VALUE=DATE:20220719;BYDAY=MO,TU,WE,TH,FR,SA,SU
  

  注意部分老旧日历服务对VALUE=DATE类型的UNTIL支持存在差异，生产环境不推荐优先使用。

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