Noda Time 1.2 发布，支持 XML、JSON 序列化和文本格式化

Noda Time 1.2 已经发布，除了提供一个用于处理 JSON 序列化的可选程序集外，还支持 XML、二进制序列化和文本格式化。它还提供了对类型Duration、OffsetDateTime 和ZonedDateTime 进行格式化和解析的能力，并包含方法Interval.Contains() 和ZonedDateTime.Calendar()，此外，还修复了若干Bug。

最新版本提供了对程序集NodaTime.Serialization.JsonNet 的支持。该程序集使用Json.NET 4.5.11 构建，同时适用于便携式和桌面平台。此外，它还在JsonSerializer 和JsonSerializerSettings 上提供了一个扩展的ConfigureForNodaTime 方法。类型NodaConverters 为每个转换器提供了公共的静态只读字段，所有这些转换器都是不可变的。或者，开发人员可以基于使用NodaPatternConverter 的模式创建自定义转换器。

Noda Time 1.2 更改了若干 API，如引入新类 DurationPattern、OffsetDateTimePattern 和 ZonedDateTimePattern。这些类分别表示解析和格式化 Duration、OffsetDateTime 和 ZonedDateTime 的模式。它还引入了新属性 GeneralsoPattern、BclRoundtripPattern 和 FullRoundtripPattern。这些属性提供对模式 o/O、r 和 s 的编程访问。该版本还包含 DateTimeZoneNotFoundException、CalendarSystem 和 InvalidNodaDataException。

在 Noda Time 1.2 中，类型 Instant、OffsetDateTime、ZonedDateTime、LocalDateTime, LocalDate、LocalTime、Offset、Interval、Duration 和 PeriodBuilder 均实现了 IXmlSerializable 接口，开发人员可以对它们进行序列化。此外，这些类型也实现了 ISerializable 接口，开发人员可以使用 BinaryFormatter 通过 [Serializable] 属性对它们进行序列化。

最新版本除了包含新的 Era.AnnoMartyrum 外，还包含 InstantPattern.WithMinMaxLabels()，前者用来取代先前命名错误的 AnnoMartyrm，后者提供了替换用于格式化最小和最大时刻的文本的能力。除了 ParseResult.Exception 外，它还增加了方法 Interval.Contains()、ZonedDateTime.Calendar 和 ZonedDateTime.GetZoneInterval()。其中，ParseResult.Exception 提供对 GetValueOrThrow() 方法可能抛出的异常的直接访问。

在先前的版本中，创建超出 long.MaxValue 值的 Period 时会发生不正确溢出。除了修复该 Bug 外，Noda Time 1.2 还修复了另一个 Bug。当使用月末和接近闰年的值调用 Period.Between() 时，后者会导致这个方法返回一个正数和负数混合的结果。对于现有的 Instant 模式 n、g 和 d，该版本还取消了对它们的大写别名的支持。

查看英文原文：**** Noda Time 1.2 Released with XML, JSON Serialization and Text Formatting