使用SharePoint API,我们经常会有时区转换的问题,SharePoint API 本身如何处理时区问题的呢?
本文主要以Modified字段为例测试相关API的行为。
CSOM API测试:
输出代码:
private static void ClientAPIOutputModified(ClientContext context, ListItem listItem){context.Load(listItem);context.ExecuteQuery();var modifiedTime = (DateTime) listItem["Modified"]; Console.WriteLine("Output Time: {0} , Kind: {1}", modifiedTime, modifiedTime.Kind);Console.WriteLine("\r\n");}
更新代码:
private static void ClientAPISetModified(ClientContext context, ListItem listItem, DateTime dateTime){Console.WriteLine("Set Time: {0} , Kind: {1}", dateTime, dateTime.Kind); listItem["Modified"] = dateTime;listItem.Update();context.ExecuteQuery();}
测试输出结果:
结论:
- 使用CSOM API查询 可能返回Utc时间也可能返回Local时间
- 使用CSOM API 更新,接受Utc时间和Local时间,Unspecified类型的时间被认为Local时间
Server API 测试:
输出代码:
private static void ServerAPIOutputModified(SPListItem listItem){var modifiedTime = (DateTime) listItem["Modified"]; Console.WriteLine("Time: {0} , Kind: {1}", modifiedTime, modifiedTime.Kind);Console.WriteLine("\r\n");}
更新代码:
private static void ServerAPISetModified(SPListItem listItem, DateTime dateTime){Console.WriteLine("Set Time: {0} , Kind: {1}", dateTime, dateTime.Kind);listItem["Modified"] = dateTime;listItem.Update();}
测试输出结果:
结论:
Server API查询只返回Local Time,更新也只接受LocalTime
使用SharePoint API的时候,处理好时区的问题,避免潜在的问题。