SharePoint Update file properties操作中UTC时间为何异常变更？

问题原因 #

时间从UTC 13:00变为UTC 05:00的核心原因是时区解析与转换逻辑导致的偏差，主要有以下两种可能：

• 输入时间被误解析为本地时间：PatchFileItem操作若未明确指定时区解析规则，可能会将带Z标识的UTC时间当成站点/用户的本地时间，再转换为UTC存储。假设你的站点时区为UTC+8，输入的2023-12-31T13:00:00.0000000Z会被识别为本地时间13:00，转换为UTC后就是05:00，最终存储并显示为2023-12-31T05:00:00Z。
• 操作参数配置遗漏时区声明：部分低代码/自动化工具中的Patch操作，默认会基于站点时区处理时间，若未手动开启“按UTC解析输入”的选项，就会触发自动转换。

解决建议 #

• 严格规范时间输入格式：确保Patch请求中的时间字段完全遵循ISO 8601标准（如YYYY-MM-DDTHH:mm:ss.fffffffZ），且明确保留Z后缀标记UTC时间。
• 检查站点时区配置：进入站点设置 → 区域设置，确认当前站点的时区是否符合预期。若需直接存储UTC时间，可调整站点时区为UTC，或在操作中强制指定时区解析规则。
• 验证操作参数：在PatchFileItem的配置界面，查找是否有“时区处理”相关选项，选择“按UTC解析输入值”，避免系统自动转换时区。

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