如何通过Google Calendar API实现每周不同时段重复同一事件？

这个需求我之前做项目时也碰到过，Google Calendar API其实支持在单个重复事件里通过组合 recurrence 规则来实现不同周几的时段差异，完全不用拆成三个独立事件，具体可以这么操作：

核心思路 #

我们可以通过「主重复规则 + 排除规则 + 自定义重复规则」的组合来实现：

1. 先定义一个覆盖所有目标周几的主重复规则，用一个基础时段（比如周二、周三的15:00-16:00）
2. 用排除规则把需要修改时段的周几（周五）从主规则中移除
3. 再用自定义重复规则单独添加周五的特殊时段（17:00-19:00），重复次数和主规则保持一致

具体API请求示例 #

以下是完整的请求体示例（以JSON格式为例，时区以Asia/Shanghai为例）：

{
  "summary": "你的重复事件标题",
  "description": "事件描述内容",
  "start": {
    "dateTime": "2024-05-14T15:00:00+08:00", // 第一个周二的基础起始时间
    "timeZone": "Asia/Shanghai"
  },
  "end": {
    "dateTime": "2024-05-14T16:00:00+08:00", // 基础结束时间
    "timeZone": "Asia/Shanghai"
  },
  "recurrence": [
    // 主规则：每周二、三、五重复，共30次
    "RRULE:FREQ=WEEKLY;INTERVAL=1;COUNT=30;BYDAY=TU,WE,FR",
    // 排除规则：移除主规则中所有周五的实例
    "EXRULE:FREQ=WEEKLY;INTERVAL=1;COUNT=30;BYDAY=FR",
    // 自定义周五的重复规则：每周五17:00开始，持续2小时，共30次
    "RDATE;TZID=Asia/Shanghai;FREQ=WEEKLY;INTERVAL=1;COUNT=30;BYDAY=FR:20240516T170000/PT2H"
  ]
}

关键规则解释 #

• RRULE：主重复规则，定义了事件的基础重复逻辑，这里覆盖了周二、周三、周五三个周几，共30次。
• EXRULE：排除规则，精准移除主规则中所有周五的实例，避免生成基础时段的周五事件。
• RDATE：自定义重复规则，单独为周五设置17:00-19:00的时段，PT2H表示持续2小时，重复次数和主规则保持一致，确保整体重复周期匹配。

注意事项 #

1. 务必保证所有规则的时区（TZID）统一，避免出现时间偏移问题。
2. 如果用UNTIL代替COUNT（比如UNTIL=20241231T235959Z），三个规则的结束时间要保持一致，确保重复周期同步。
3. 测试时可以先把COUNT设为3，验证效果没问题后再改成30次，避免出错后批量删除麻烦。

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