为何UtcDateTime函数未对UTC日期执行偏移量添加与转换？

嘿，我来帮你理清这个问题——核心问题出在你对DateTimeOffset.UtcDateTime属性的理解和使用方式上，咱们一步步拆解：

1. 你踩坑的核心原因：UtcDateTime是只读的“派生属性” #

DateTimeOffset.UtcDateTime是一个只读属性，它的作用是返回当前DateTimeOffset实例转换为UTC时间后的DateTime值。你没法直接修改这个属性的值——任何试图给它加TimeSpan偏移的操作，只会返回一个新的DateTime副本，完全不会影响原DateTimeOffset对象的状态，这就是你感觉“转换未生效”的根本原因。

简单说：UtcDateTime是基于原DateTimeOffset的时间和偏移量计算出来的结果，不是一个可手动修改的字段。

2. 正确的实现思路：构建正确的DateTimeOffset实例 #

你的目标应该是根据用户的时区ID，先把源DateTime转换为对应时区的DateTimeOffset——此时这个实例的UtcDateTime会自动正确计算出对应的UTC时间，根本不需要手动修改它。

下面给你两种常见场景的正确代码实现：

场景1：源时间是用户时区的本地时间，要生成带偏移的DateTimeOffset #

public static DateTimeOffset GetDateTimeOffsetForUserTimeZone(DateTime sourceLocalTime, string timeZoneId)
{
    // 获取用户指定的时区信息
    TimeZoneInfo userTimeZone = TimeZoneInfo.FindSystemTimeZoneById(timeZoneId);
    
    // 检查时间是否有效（避免夏令时切换导致的无效时间）
    if (TimeZoneInfo.IsInvalidTime(sourceLocalTime))
    {
        throw new ArgumentException("该时间在目标时区中无效，可能是夏令时切换导致的缺失时段");
    }
    
    // 获取该时区在指定时间的UTC偏移量
    TimeSpan utcOffset = userTimeZone.GetUtcOffset(sourceLocalTime);
    
    // 创建正确的DateTimeOffset实例
    DateTimeOffset result = new DateTimeOffset(sourceLocalTime, utcOffset);
    
    // 此时result.UtcDateTime就是自动转换后的UTC时间，直接使用即可
    return result;
}

场景2：源时间是UTC时间，要转换为用户时区的DateTimeOffset #

如果你手里的源时间已经是UTC，需要转换到用户时区：

public static DateTimeOffset ConvertUtcToUserTimeZone(DateTime sourceUtcTime, string timeZoneId)
{
    TimeZoneInfo userTimeZone = TimeZoneInfo.FindSystemTimeZoneById(timeZoneId);
    // 将UTC时间转换为用户时区的本地时间
    DateTime userLocalTime = TimeZoneInfo.ConvertTimeFromUtc(sourceUtcTime, userTimeZone);
    // 获取该时区的偏移量
    TimeSpan utcOffset = userTimeZone.GetUtcOffset(userLocalTime);
    // 构建DateTimeOffset实例
    return new DateTimeOffset(userLocalTime, utcOffset);
}

3. 再总结下关键要点 #

• 永远不要试图修改DateTimeOffset.UtcDateTime——它是只读的派生值，修改副本毫无意义
• 要得到正确的UTC/时区时间，核心是构建正确的DateTimeOffset实例（包含正确的时间和对应的时区偏移）
• 处理时区时尽量使用TimeZoneInfo类，它能自动处理夏令时等复杂场景，避免手动计算偏移出错

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