使用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的时候，处理好时区的问题，避免潜在的问题。