Ubuntu与Windows下TimeZoneInfo时区转换不一致问题排查

测试代码 #

using FluentAssertions;
using FluentAssertions.Extensions;

namespace Tests.Unit.Api;

[TestFixture]
[Category("Unit")]
public class Tests
{
    [TestCase(1953,4,12,"21:53")] // 失败
    [TestCase(1953,2,12,"20:53")] // 成功
    [TestCase(2023,4,12,"21:53")] // 成功
    [TestCase(2023,2,12,"20:53")] // 成功
    public void WhyDoesThisFail(int year, int month, int day, string expectedTime)
    {
        // Arrange
        var timeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Europe/Berlin");
        var dateTime = new DateTime(year,month,day,19,53,3,DateTimeKind.Utc);

        // Act
        var result = TimeZoneInfo.ConvertTimeFromUtc(dateTime, timeZoneInfo);

        // Assert
        TimeOnly.FromDateTime(result).ToShortTimeString().Should().Be(expectedTime);
    }
}

异常情况 #

在Win11环境下（Rider/Visual Studio/dotnet test）测试全部通过，但在GitHub Action的Ubuntu 22.04.2 LTS环境中，第一个测试用例失败：

Failed WhyDoesThisFail [2 ms]
  Error Message:
   Expected TimeOnly.FromDateTime(result).ToShortTimeString() to be "21:53", but "20:53" differs near "0:5" (index 1).

问题解答 #

1. 问题产生的原因 #

核心是不同操作系统依赖的时区数据库版本不一致：

• Windows使用微软自家维护的时区数据，Linux（Ubuntu）则使用IANA时区数据库。
• 1953年欧洲柏林的夏令时规则在两类数据库中的记录存在差异：Windows时区数据认为1953年4月12日已启用夏令时（UTC+2），所以UTC时间19:53转换后为21:53；但IANA数据库中该年份柏林的夏令时启用时间更晚，当天仍处于标准时间（UTC+1），转换结果为20:53，最终导致测试不一致。

2. 跨平台稳定的解决方案 #

要消除平台差异，需统一时区数据来源，不依赖操作系统自带的时区库：

• 使用NodaTime库替代.NET原生的TimeZoneInfo，它内置了IANA时区数据库，跨平台行为完全一致。
• 调整测试代码，用NodaTime的API完成时区转换：

  using FluentAssertions;
  using NodaTime;
  
  namespace Tests.Unit.Api;
  
  [TestFixture]
  [Category("Unit")]
  public class Tests
  {
      [TestCase(1953,4,12,"21:53")]
      [TestCase(1953,2,12,"20:53")]
      [TestCase(2023,4,12,"21:53")]
      [TestCase(2023,2,12,"20:53")]
      public void FixedTest(int year, int month, int day, string expectedTime)
      {
          // Arrange
          var timeZone = DateTimeZoneProviders.Tzdb["Europe/Berlin"];
          var utcInstant = Instant.FromUtc(year, month, day, 19, 53, 3);
  
          // Act
          var zonedDateTime = utcInstant.InZone(timeZone);
          var resultTime = zonedDateTime.TimeOfDay.ToString("HH:mm");
  
          // Assert
          resultTime.Should().Be(expectedTime);
      }
  }
  

• 若必须使用.NET原生API，需确保所有平台同步时区数据版本，但实践中维护成本极高，因此优先推荐使用NodaTime保证跨平台一致性。

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