NodaTime：.NET 开源强大的高级日期和时间库

郑子铭

发布于 2025-03-10 20:13:19

2600

代码可运行

文章被收录于专栏：DotNet NB && CloudNativeDotNet NB && CloudNative

运行总次数：0

代码可运行

NodaTime 是一个为 .NET 设计的开源高级日期和时间库，提供了比 .NET 框架自带的 DateTime 和 DateTimeOffset 更加丰富和可靠的日期时间操作功能。

1. 安装 NodaTime

首先，通过 NuGet 安装 NodaTime 包：

Install-Package NodaTime

2. 基本概念

NodaTime 提供了多种日期和时间类型，主要包括：

• Instant：表示从 Unix 纪元（1970-01-01T00:00:00Z）开始的纳秒数，是一个全局唯一的时间点。
• LocalDate：表示本地日期，不包含时间或时区信息。
• LocalTime：表示本地时间，不包含日期或时区信息。
• LocalDateTime：表示本地日期和时间，不包含时区信息。
• ZonedDateTime：表示带时区的日期和时间。
• Duration：表示时间间隔，精确到纳秒。
• Period：表示日期和时间的周期，可以包含年、月、日、小时、分钟、秒等。

3. 使用教程

3.1 获取当前时间

using NodaTime;

// 获取当前 UTC 时间
Instant now = SystemClock.Instance.GetCurrentInstant();
Console.WriteLine($"Current UTC time: {now}");

3.2 时区转换

// 将 Instant 转换为带时区的时间
ZonedDateTime nowInUtc = now.InUtc();
Console.WriteLine($"Current UTC time: {nowInUtc}");

// 获取伦敦时区并进行转换
var london = DateTimeZoneProviders.Tzdb["Europe/London"];
ZonedDateTime nowInLondon = now.InZone(london);
Console.WriteLine($"Current London time: {nowInLondon}");

3.3 创建本地日期和时间

// 创建本地日期和时间
LocalDate localDate = new LocalDate(2024, 7, 26);
LocalTime localTime = new LocalTime(10, 26, 9);
LocalDateTime localDateTime = localDate.At(localTime);
Console.WriteLine($"Local date and time: {localDateTime}");

3.4 时区转换（带时区的时间）

// 创建带时区的时间
LocalDateTime localDateTime = LocalDateTime.FromDateTime(new DateTime(2024, 7, 26, 10, 26, 9));
DateTimeZone systemTimeZone = DateTimeZoneProviders.Tzdb.GetSystemDefault();
DateTimeZone newYorkTimeZone = DateTimeZoneProviders.Tzdb["America/New_York"];
ZonedDateTime zonedDateTime = localDateTime.InZoneLeniently(newYorkTimeZone);
Console.WriteLine($"New York time: {zonedDateTime}");

3.5 时间间隔计算

// 计算时间间隔
Instant now = SystemClock.Instance.GetCurrentInstant();
Duration duration = Duration.FromMinutes(3);
Instant then = now + duration;
Console.WriteLine($"Current time: {now}");
Console.WriteLine($"Time after 3 minutes: {then}");

3.6 格式化输出

// 格式化日期输出
LocalDate localDate = new LocalDate(2024, 7, 26);
string formattedString = localDate.ToString("yyyy-MM-dd");
Console.WriteLine($"Formatted date: {formattedString}");