Microsoft Graph Calendar API全日历事件时区偏好不生效问题

问题根源 #

Outlook日历API对**全日历事件（All-day Event）**的时区处理逻辑和普通事件存在差异：

• 普通事件会严格遵循Prefer: outlook.timezone请求头，将起止时间转换为指定时区返回。
• 全日历事件在Exchange/Outlook体系中被标记为「无时区的日期型事件」，API不会对其执行时区转换操作，始终返回事件创建时的时区（即你创建时的GMT+5），更换请求头中的时区也不会改变这一结果。

解决步骤 #

1. 获取事件原始时区
   调用list或get接口时，通过$select参数指定返回originalStartTimeZone字段，该字段会明确返回事件创建时的时区信息。示例请求参数：

   $select=subject,isAllDay,start,end,originalStartTimeZone
   

   这个字段的值就是事件的原始时区（比如GMT+05:00）。

2. 自行处理时区转换
   由于全日历事件覆盖的是完整自然日，你可以基于originalStartTimeZone对应的日期，自行转换到目标时区的自然日：

   • 比如用户指定时区为GMT+8，那么GMT+5的10月7日全日历事件，转换后直接展示为GMT+8的10月7日即可（无需处理时分秒，因为全日历事件本身不包含具体时间点）。
   • 若遇到跨时区边界场景（比如创建时区的自然日在目标时区跨两天），可根据业务需求选择展示逻辑（通常以用户本地时区的自然日为准）。

3. 区分事件类型处理
   通过返回结果中的isAllDay字段判断事件类型：

   • 普通事件直接使用start和end字段的时区信息即可。
   • 全日历事件忽略start.timeZone，改用originalStartTimeZone来做时区转换和展示。

注意事项 #

• 必须通过$select参数主动请求originalStartTimeZone，该字段默认不会被返回。
• 全日历事件的start和end字段时间值始终是创建时区的00:00到次日00:00，不要依赖这两个字段的时区信息判断事件时区。

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