C#调用MsGraph更新Outlook日历事件时起止属性时区异常问题

两个写法错误共同导致了PATCH更新后事件时区被识别为UTC的问题：

• Prefer: outlook.timezone是请求级HTTP头，不属于内容头。之前POST操作时把这个头加在StringContent.Headers上属于不符合HTTP规范的写法，POST接口底层做了容错才正常生效；自己构造HttpRequestMessage发PATCH请求时，加在内容头上的Prefer头不会随请求发出，Microsoft Graph收不到时区偏好配置，默认回退到UTC处理时间。
• 时间序列化逻辑有隐患：用:O往返格式序列化DateTime时，如果startDate、startTime对应的DateTime实例Kind属性为Local，序列化出的时间字符串会自动携带本地时区偏移后缀（比如中欧夏令时UTC+2环境下会带+02:00），和手动传入的TimeZone = "W. Europe Standard Time"字段不匹配。PATCH接口更新时会优先按时间字符串自带的偏移量转换存储，忽略传入的TimeZone值，最终事件本身存储的时区标记为UTC。

日历视图显示时间正常是因为视图层会按用户邮箱配置的默认时区自动做时间转换，但事件详情页直接读取事件本身存储的时区字段，就会出现2小时偏移、显示UTC的问题。

1. 修正时间构造与序列化逻辑 #

构造时间时显式指定DateTimeKind.Unspecified，用固定格式生成不带时区偏移的ISO时间字符串，避免序列化时自动附加偏移：

// 显式指定时间Kind为Unspecified，禁止序列化时自动附加本地时区偏移
var eventStart = DateTime.SpecifyKind(
    startDate.Date.Add(startTime.TimeOfDay),
    DateTimeKind.Unspecified
);
var eventEnd = DateTime.SpecifyKind(
    eventStart.AddMinutes(duration),
    DateTimeKind.Unspecified
);

data.Start = new EventDateTime
{
    DateTime = eventStart.ToString("yyyy-MM-ddTHH:mm:ss"),
    TimeZone = "W. Europe Standard Time"
};
data.End = new EventDateTime
{
    DateTime = eventEnd.ToString("yyyy-MM-ddTHH:mm:ss"),
    TimeZone = "W. Europe Standard Time"
};

2. 修正PATCH请求的头添加位置 #

Prefer头必须添加到HttpRequestMessage的请求头集合，而非内容头集合，同时补充标准Accept头避免返回格式异常：

var task = $"users/{outlookUser.Id}/calendar/events/{outlookId}";
var request = new HttpRequestMessage(new HttpMethod("PATCH"), $"{webApiUrl}v1.0/{task}")
{
    Content = jsonData                
};
// 关键：将Prefer头加在请求级Headers集合
request.Headers.Add("Prefer", "outlook.timezone=\"W. Europe Standard Time\"");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = HttpClient.SendAsync(request).Result;

额外注意 #

• 建议把之前POST请求里加在Content.Headers上的Prefer头也移到请求头位置，和PATCH保持一致，避免后续.NET版本升级后POST也出现兼容问题。
• 如果HttpClient实例配置了默认请求头，先检查是否存在冲突的时区配置，及时清理。
• 验证时可以在PATCH请求成功后立刻调用GET接口拉取事件详情，确认返回的Start.TimeZone、End.TimeZone字段值为W. Europe Standard Time即为修复生效。

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