如何将MySQL的convert_tz()时区转换函数实现为C#版本函数

MySQL内置的CONVERT_TZ(dt, from_tz, to_tz)核心逻辑为：接收一个时间值、源时区标识符、目标时区标识符，返回转换后的时间值，转换失败时返回null。C#实现完全对齐该逻辑，同时兼容不同版本.NET的运行环境，具体实现方案如下：

方案1：原生实现（适配.NET Core 3.0+ / .NET 5+） #

不需要引入第三方依赖，.NET高版本内置的TimeZoneInfo已经支持IANA时区（和MySQL默认使用的时区格式一致），实现代码如下：

/// <summary>
/// 等效于MySQL CONVERT_TZ()的C#自定义函数
/// </summary>
/// <param name="dateTime">待转换的原始时间</param>
/// <param name="fromTimeZoneId">源时区标识符，支持IANA/Windows两种格式</param>
/// <param name="toTimeZoneId">目标时区标识符，支持IANA/Windows两种格式</param>
/// <returns>转换后的时间，转换失败返回null</returns>
public static DateTime? ConvertTz(DateTime dateTime, string fromTimeZoneId, string toTimeZoneId)
{
    try
    {
        // 校验源时区合法性
        if (!TimeZoneInfo.TryFindSystemTimeZoneById(fromTimeZoneId, out var fromTimeZone))
        {
            return null;
        }
        // 校验目标时区合法性
        if (!TimeZoneInfo.TryFindSystemTimeZoneById(toTimeZoneId, out var toTimeZone))
        {
            return null;
        }
        // 先转UTC再转目标时区，避免夏令时、时区偏移变更等边界问题
        DateTime utcTime = TimeZoneInfo.ConvertTimeToUtc(dateTime, fromTimeZone);
        return TimeZoneInfo.ConvertTimeFromUtc(utcTime, toTimeZone);
    }
    catch (ArgumentException)
    {
        // 处理源时间在源时区不存在的异常（比如夏令时跳变的空缺时间点）
        return null;
    }
}

调用示例 #

// 对应MySQL语句：SELECT CONVERT_TZ('2024-05-20 12:00:00', 'UTC', 'Asia/Shanghai');
var result = ConvertTz(new DateTime(2024,5,20,12,0,0), "UTC", "Asia/Shanghai");
// 返回结果为 2024/5/20 20:00:00

注意：.NET Framework环境原生不支持IANA时区，需要手动做时区标识符映射，或者使用方案2实现。

方案2：全版本兼容实现（基于NodaTime） #

如果需要跨平台运行、兼容旧版本.NET，或者要求和MySQL转换结果100%对齐，推荐用NodaTime库实现，自带完整的IANA时区数据库，不依赖系统时区配置：

1. 首先安装NuGet包：NodaTime
2. 实现代码如下：

using NodaTime;
using NodaTime.TimeZones;

public static DateTime? ConvertTz(DateTime dateTime, string fromTimeZoneId, string toTimeZoneId)
{
    try
    {
        var tzSource = TzdbDateTimeZoneSource.Default;
        // 校验时区存在性
        if (!tzSource.GetIds().Contains(fromTimeZoneId) || !tzSource.GetIds().Contains(toTimeZoneId))
        {
            return null;
        }
        var fromZone = DateTimeZoneProviders.Tzdb[fromTimeZoneId];
        var toZone = DateTimeZoneProviders.Tzdb[toTimeZoneId];
        
        // 构造源时区时间，默认用宽容模式处理夏令时模糊/无效时间，和MySQL逻辑对齐
        var localTime = LocalDateTime.FromDateTime(dateTime);
        var sourceZonedTime = fromZone.AtLeniently(localTime);
        // 转换到目标时区
        var targetZonedTime = sourceZonedTime.WithZone(toZone);
        return targetZonedTime.LocalDateTime.ToDateTimeUnspecified();
    }
    catch
    {
        return null;
    }
}

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