使用 Noda Time 在时区之间转换

Posted 2023-02-25

【中文标题】使用 Noda Time 在时区之间转换

【英文标题】：Converting between time zones with Noda Time

【发布时间】：2013-10-15 16:06:18

【问题描述】：

我目前正在努力确保我们的旧后端可以支持根据用户当前的时区（或者，更具体地说是偏移量）解析日期时间。我们的服务器采用东部标准时间，我们的大部分日期时间都来自那里。但是，对于处于其他时区的用户，在检索这些日期时间时需要转换到他们的时区（或者，在这种情况下，偏移量）。此外，来自用户的日期时间必须转换为东部标准时间，然后才能持久保存在服务器上。鉴于我们正在开发的前端是基于 Web 的，我能够在几分钟内检索到用户的偏移量，并将该值传递到我在标头中的服务层。我查看了 Noda Time 并认为它是一个很棒的 AP​​I。它确实迫使我在更精细的问题上思考时间，但我仍然不能 100% 确定我是否正确地使用了它。以下是我为上述转换编写的方法。我已经对它们进行了测试，它们似乎有效。鉴于上述情况，这看起来像是对库的正确使用吗？我是否正确考虑了日期时间？

public static DateTime ConvertToUtcFromEasternTimeZone(DateTime easternDateTime)

    NodaTime.DateTimeZone easternTimeZone = NodaTime.DateTimeZoneProviders.Tzdb.GetZoneOrNull("America/New_York");
    ZoneLocalMappingResolver customResolver = Resolvers.CreateMappingResolver(Resolvers.ReturnLater, Resolvers.ReturnStartOfIntervalAfter);
    var easternLocalDateTime = LocalDateTime.FromDateTime(easternDateTime);
    var easternZonedDateTime = easternTimeZone.ResolveLocal(easternLocalDateTime, customResolver);
    return easternZonedDateTime.ToDateTimeUtc();


public static DateTime ConvertToEasternTimeZoneFromUtc(DateTime utcDateTime)

    NodaTime.DateTimeZone easternTimeZone = NodaTime.DateTimeZoneProviders.Tzdb.GetZoneOrNull("America/New_York");
    NodaTime.DateTimeZone utcTimeZone = NodaTime.DateTimeZoneProviders.Tzdb.GetZoneOrNull("UTC");
    ZoneLocalMappingResolver customResolver = Resolvers.CreateMappingResolver(Resolvers.ReturnLater, Resolvers.ReturnStartOfIntervalAfter);
    var utcLocal = LocalDateTime.FromDateTime(utcDateTime);
    var utcZonedDateTime = utcTimeZone.ResolveLocal(utcLocal, customResolver);
    var easternZonedDateTime = utcZonedDateTime.ToInstant().InZone(easternTimeZone);
    return easternZonedDateTime.ToDateTimeUnspecified();


public static DateTime ConvertToUtc(DateTime dateTime, int offsetInMinutes)

    LocalDateTime localDateTime = LocalDateTime.FromDateTime(dateTime);
    var convertedDateTime = localDateTime.PlusMinutes(offsetInMinutes).ToDateTimeUnspecified();
    return convertedDateTime;


public static DateTime ConvertFromUtc(DateTime dateTime, int offsetInMinutes)

    LocalDateTime localDateTime = LocalDateTime.FromDateTime(dateTime);
    var convertedDateTime = localDateTime.PlusMinutes(-offsetInMinutes).ToDateTimeUnspecified();
    return convertedDateTime;

这里的想法是，当我在 UTC 时间和数据库中的时区之间进行解析时，时区很重要。当我在客户端时间和 UTC 时间之间进行解析时，偏移量很重要。

未来，我们可以坚持 UTC 时间，这会更容易。目前，这种解决方案只是权宜之计。

我们的想法是从...开始

客户端 -> UTC +/- 偏移量 -> UTC -> 东部时间 -> 数据库

数据库 -> 东部时间 -> UTC -> UTC +/- 偏移量 -> 客户端

到最后……

客户端 -> UTC +/- 偏移量 -> UTC -> 数据库

数据库 -> UTC -> UTC +/- 偏移量 -> 客户端

【问题讨论】：

当您说“我们的服务器采用东部标准时间”时，您实际上是指“我们的服务器采用东部标准时间”（美国东部标准时间和美国东部时间全年不同）吗？它有所作为。

是的，乔恩。感谢您的澄清。我确实需要考虑夏令时。

【参考方案1】：

我想补充一点，第一种方法可以在没有customResolver的情况下重写。

using System;
using NodaTime;

namespace qwerty

    class Program
    
        static void Main(string[] args)
        
            var convertedInUTC = ConvertToUtcFromCustomTimeZone("America/Chihuahua", DateTime.Now);
            Console.WriteLine(convertedInUTC);
        

        private static DateTime ConvertToUtcFromCustomTimeZone(string timezone, DateTime datetime) 
        
            DateTimeZone zone = DateTimeZoneProviders.Tzdb[timezone];
            var localtime = LocalDateTime.FromDateTime(datetime);
            var zonedtime = localtime.InZoneLeniently(zone);
            return zonedtime.ToInstant().InZone(zone).ToDateTimeUtc();
        
    

【参考方案2】：

您的第一个方法看起来不错，虽然我们不知道 customResolver 是什么。

你的第二种方法有点不对劲。我建议：

public static DateTime ConvertToEasternTimeZoneFromUtc(DateTime utcDateTime)

    var easternTimeZone = DateTimeZoneProviders.Tzdb["America/New_York"];
    return Instant.FromDateTimeUtc(utcDateTime)
                  .InZone(easternTimeZone)
                  .ToDateTimeUnspecified();

请注意，您无需在每个方法调用中查找东部时区 - 只需：

private static readonly DateTimeZone EasternTimeZone = 
    DateTimeZoneProviders.Tzdb["America/New_York"];

...然后在任何地方使用它。

您的第三种和第四种方法不是我认为的惯用方法 - 对于您应该使用的第三种方法：

public static DateTime ConvertToUtc(DateTime dateTime, int offsetInMinutes)

    var offset = Offset.FromMinutes(offsetInMinutes);
    var localDateTime = LocalDateTime.FromDateTime(dateTime);
    return new OffsetDateTime(localDateTime, offset).ToInstant()
                                                    .ToDateTimeUtc();

第四种方法似乎有点棘手，因为我们没有提供所有我们应该使用OffsetDateTime 进行转换的东西。您使用的代码可能还可以，但如果您可以使用OffsetDateTime，它肯定会更简洁。

编辑：我现在向Instant 添加了一个方法，以使第四个方法更简洁。它将成为 1.2.0 的一部分，您可以使用：

public static DateTime ConvertFromUtc(DateTime dateTime, int offsetInMinutes)

    var offset = Offset.FromMinutes(offsetInMinutes);
    var instant = Instant.FromDateTimeUtc(dateTime);
    return instant.WithOffset(offset)
                  .LocalDateTime
                  .ToDateTimeUnspecified();

【讨论】：

非常感谢，乔恩。老实说，我有点不清楚解析器是如何工作的。根据我所读到的内容，它们似乎可以用来计算夏令时。但是，我注意到您在 ConvertToEasternTimeZoneFromUtc() 的实现中没有使用一个。我有兴趣为数据库持久日期时间和 UTC 之间的转换考虑夏令时。我不必担心在 UTC 和客户日期时间之间进行转换，因为我从客户那里得到了以分钟为单位的偏移量（这隐含地解释了 DST）。

另外，我拥有的库版本没有 Offset.FromMinutes()。所以，我已将其转换为 Offset.FromHoursAndMinutes(0, offsetInMinutes)。