如何直接将带偏移量的DateTime字符串解析为NodaTime类型？

问题描述 #

给定字符串「2020-12-15T12:10:00.202-08:00」，需直接解析为NodaTime的LocalDateTime、ZonedDateTime、LocalDate、Instant等类型，而非通过.NET DateTime中转；最终目标是将该时间的偏移量/时区转换为另一个时区。自定义解析模式时曾遇到格式符号使用问题。

核心解决方案 #

1. 解析为ZonedDateTime（适配带偏移量的字符串） #

这是处理带偏移量时间字符串的最优方式，注意格式符号的正确匹配：

• 字符串末尾的-08:00是偏移量，对应NodaTime格式符号o<G>（带冒号的通用偏移格式），而非z（z代表时区ID，如America/Los_Angeles）
• 毫秒部分用fff匹配3位数字即可，无需9位（9位对应纳秒级，你的字符串仅含3位毫秒）

代码示例：

// 定义匹配带偏移量的时间格式
var zonedPattern = ZonedDateTimePattern.CreateWithInvariantCulture(
    "uuuu'-'MM'-'dd'T'HH':'mm':'ss.fff o<G>",
    DateTimeZoneProviders.Tzdb);

// 解析字符串
var parseResult = zonedPattern.Parse("2020-12-15T12:10:00.202-08:00");
if (parseResult.Success)
{
    ZonedDateTime zonedDateTime = parseResult.Value;
    // 后续业务操作
}

补充：若字符串偏移量无冒号（如-0800），则改用格式符号o<g>。

2. 解析为LocalDateTime #

若仅需提取本地时间部分（忽略偏移量），直接使用LocalDateTimePattern，格式字符串只匹配时间主体即可：

var localPattern = LocalDateTimePattern.CreateWithInvariantCulture(
    "uuuu'-'MM'-'dd'T'HH':'mm':'ss.fff");

var parseResult = localPattern.Parse("2020-12-15T12:10:00.202-08:00");
if (parseResult.Success)
{
    LocalDateTime localDateTime = parseResult.Value;
    // 解析时会自动忽略末尾的-08:00偏移量
}

注意：LocalDateTime本身不含时区/偏移量信息，若强行在格式中添加偏移量符号，会导致解析失败。

3. 解析为LocalDate #

只需匹配日期部分的格式即可：

var datePattern = LocalDatePattern.CreateWithInvariantCulture("uuuu'-'MM'-'dd");

var parseResult = datePattern.Parse("2020-12-15T12:10:00.202-08:00");
if (parseResult.Success)
{
    LocalDate localDate = parseResult.Value;
}

4. 解析为Instant（UTC时间戳） #

有两种实现方式：

// 方式1：从已解析的ZonedDateTime转换
ZonedDateTime zonedDateTime = /* 前面解析得到的结果 */;
Instant instant = zonedDateTime.ToInstant();

// 方式2：直接用InstantPattern解析
var instantPattern = InstantPattern.CreateWithInvariantCulture("uuuu'-'MM'-'dd'T'HH':'mm':'ss.fff o<G>");
var parseResult = instantPattern.Parse("2020-12-15T12:10:00.202-08:00");
if (parseResult.Success)
{
    Instant instant = parseResult.Value;
}

时区转换（最终目标） #

解析得到ZonedDateTime后，调用WithZone方法即可转换到目标时区：

// 示例：转换到上海时区（Asia/Shanghai）
var targetZone = DateTimeZoneProviders.Tzdb["Asia/Shanghai"];
ZonedDateTime targetZonedDateTime = zonedDateTime.WithZone(targetZone);

// 转换会自动处理时区偏移、夏令时等规则

关键注意点 #

• NodaTime格式符号与.NET DateTime不完全一致：
  • 年份推荐用uuuu（ISO年份）而非yyyy（历法年份），公历场景下两者一致，但其他历法有差异
  • 偏移量用o系列符号，z仅用于匹配时区ID
• 所有解析操作必须检查parseResult.Success，避免无效字符串引发异常

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