.NET中将C# TimeOnly值转换为本地TimeOnly的最佳方法

首先明确核心前提：TimeOnly 结构本身仅存储一天0点到23:59:59.9999999的时间刻度，不携带任何时区、日期关联信息，因此不存在直接的“内置转换方法”——所有转换都必须先绑定一个参考日期，组合为带时区的完整时间点完成时区转换后，再提取时间部分得到结果。

推荐实现：封装通用扩展方法 #

直接基于.NET 官方提供的 TimeZoneInfo 能力封装扩展方法，时区规则、夏令时计算完全复用系统内置逻辑，无额外维护成本：

public static class TimeOnlyTimeZoneConverter
{
    public static TimeOnly ConvertToTimeZone(
        this TimeOnly sourceTime, 
        TimeZoneInfo sourceZone, 
        TimeZoneInfo targetZone, 
        DateOnly? referenceDate = null)
    {
        // 未指定参考日期时默认取当前日期，适配绝大多数日常场景
        DateOnly refDate = referenceDate ?? DateOnly.FromDateTime(DateTime.Today);
        // 组合参考日期与源时间，生成源时区下的完整时间
        DateTime sourceFullTime = refDate.ToDateTime(sourceTime);
        // 执行官方时区转换
        DateTime targetFullTime = TimeZoneInfo.ConvertTime(sourceFullTime, sourceZone, targetZone);
        // 提取目标时间的TimeOnly部分返回
        return TimeOnly.FromDateTime(targetFullTime);
    }
}

调用示例 #

如果需要把UTC标准时间的TimeOnly转为本地时区对应的TimeOnly，直接按如下方式调用即可：

// 例如待转换的是UTC时间 14:00:00
TimeOnly utcTime = new TimeOnly(14, 0, 0);
// 转换为本地时间
TimeOnly localTime = utcTime.ConvertToTimeZone(TimeZoneInfo.Utc, TimeZoneInfo.Local);

如果是其他时区转本地，只需要把sourceZone参数替换为对应时区的TimeZoneInfo实例即可，例如东京东九区转本地：

TimeZoneInfo tokyoZone = TimeZoneInfo.FindSystemTimeZoneById("Tokyo Standard Time");
TimeOnly tokyoTime = new TimeOnly(9, 0, 0);
TimeOnly localTimeFromTokyo = tokyoTime.ConvertToTimeZone(tokyoZone, TimeZoneInfo.Local);

特殊场景注意事项 #

• 夏令时跳变问题：部分时区在每年夏令时切换时会出现时间断层（例如时间从凌晨2点拨到3点，2:00-2:59的时间不存在）或时间重叠（时间从凌晨2点拨回1点，1:00-1:59的时间出现两次）。默认实现会遵循TimeZoneInfo的默认处理逻辑：不存在的时间会自动调整到跳变后的有效时间，重叠时间默认取偏移较大（时间更早）的结果，如果业务有特殊规则可以在转换前增加自定义判断逻辑。
• 禁止直接加减时区偏移计算：不要图省事直接给TimeOnly的Ticks加当前时区和UTC的时间差，这种写法完全忽略夏令时、历史时区规则调整的情况，在切换日会得到错误结果。

内容的提问来源于stack exchange，提问作者Дмитрий Власов