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}");
项目地址
- GitHub 地址：
- 官方文档
