SharePoint Online数据库DateTime存储及时区转换问题咨询

一、SharePoint Online的DateTime存储规则 #

首先明确：SharePoint Online所有DateTime类型的字段（比如Created、Modified、自定义日期字段）都是以UTC时间存储在数据库中的，和你的站点时区、本地时区无关。展示时会自动转换为站点配置的时区，但通过API（CSOM、REST、PnP PowerShell）获取时，默认返回的是UTC时间——这就是你遇到日期差一天的核心原因：比如UTC时间是当天凌晨0点，转换到瑞典时区（W.Europe Standard Time，夏令时UTC+2、冬令时UTC+1）就是前一天的晚上22/23点，取日期部分就会和本地“今日”差一天。

二、C#中日期对比的正确姿势 #

在C#里，你需要把从SPO获取的UTC时间转换为瑞典本地时区，再和本地的“今日”日期（同样转换为瑞典时区的日期部分）对比：

// 假设从SPO API获取的UTC日期（比如CSOM的ListItem["Created"]返回的是UTC时间）
DateTime spoUtcDate = (DateTime)listItem["Created"];

// 获取瑞典时区对象
TimeZoneInfo swedenTimeZone = TimeZoneInfo.FindSystemTimeZoneById("W.Europe Standard Time");

// 将UTC时间转换为瑞典本地时间
DateTime swedenLocalDate = TimeZoneInfo.ConvertTimeFromUtc(spoUtcDate, swedenTimeZone);

// 获取瑞典时区的今日日期（仅取日期部分，忽略时间）
DateTime todayInSweden = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, swedenTimeZone).Date;

// 对比日期
bool isToday = swedenLocalDate.Date.Equals(todayInSweden);

三、PowerShell中的解决方法（含时区排查） #

针对你提到的“无法找到时区”的问题，先给你正确的转换代码，再分析可能的问题：

正确的PowerShell示例代码

# 1. 从SPO获取目标日期（这里以PnP PowerShell为例）
$targetItem = Get-PnPListItem -List "你的列表名称" -Id 1
$spoUtcDate = $targetItem["Created"]  # 注意：此值为UTC时间

# 2. 获取瑞典时区（处理可能的时区找不到问题）
try {
    $swedenZone = [System.TimeZoneInfo]::FindSystemTimeZoneById("W.Europe Standard Time")
}
catch {
    Write-Warning "找不到指定时区，正在列出系统可用时区..."
    # 列出系统中所有时区，方便排查正确ID
    [System.TimeZoneInfo]::GetSystemTimeZones() | Select-Object Id, DisplayName | Format-Table -AutoSize
    throw $_
}

# 3. 转换为瑞典本地时间
$swedenLocalDate = [System.TimeZoneInfo]::ConvertTimeFromUtc($spoUtcDate, $swedenZone)

# 4. 获取瑞典时区的今日日期（仅日期部分）
$todayInSweden = [System.TimeZoneInfo]::ConvertTimeFromUtc([DateTime]::UtcNow, $swedenZone).Date

# 5. 对比日期
if ($swedenLocalDate.Date -eq $todayInSweden) {
    Write-Host "✅ 该日期属于今天（瑞典时区）"
}
else {
    $dayDiff = ($swedenLocalDate.Date - $todayInSweden).Days
    Write-Host "❌ 该日期与今日相差 $dayDiff 天"
}

时区找不到的可能原因及排查

1. 时区ID拼写错误：虽然FindSystemTimeZoneById不区分大小写，但要确保ID完全正确——瑞典对应的标准ID就是W.Europe Standard Time，你可以运行以下命令确认：

   [System.TimeZoneInfo]::GetSystemTimeZones() | Where-Object { $_.DisplayName -match "Sweden" } | Select-Object Id, DisplayName
   

2. 非Windows环境运行PowerShell：如果是在Linux/macOS上运行PowerShell，时区ID采用IANA格式，瑞典对应的是Europe/Stockholm，这时候需要替换代码中的时区ID。
3. 系统时区缺失：极少数情况下，系统可能没有安装该时区包，这时候需要检查系统的时区配置。

关键提醒 #

对比日期时一定要只取日期部分（.Date属性），否则时间部分的差异会导致对比失败——比如瑞典本地时间是前一天23:59，和今日00:01的日期部分不同，但时间只差2分钟，这时候只对比日期才是正确的逻辑。

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