.NET 6: New DateOnly and TimeOnly strcuts

Background and Motivation

.NET 目前有用于处理日期和时间的DateTime和DateTimeOffset。但在许多情况下，用户需要处理日期而根本不关心时间部分，也存在需要处理时间而不关心日期部分的场景。当用户试图通过使用DateTime和DateTimeOffset来解决这个问题，需要截断他们不需要的部分，并且希望确保剩下的值不受影响。这很容易出错，因为DateTime和DateTimeOffset也携带一些与时区相关的内容。

这就是为什么 .NET 6 推出了DateOnly和TimeOnly的原因。

Intro

官方介绍：

DateOnly只关心DateTime的日期部分
TimeOnly只关心DateTime的时间部分。
DateOnly适用于生日、周年纪念日和工作日等场景。
TimeOnly适用于定期会议、闹钟和每周营业时间等场景。
补充了现有的日期/时间类型（DateTime，DateTimeOffset，TimeSpan，TimeZoneInfo）。
定义在System命名空间中，与现有的相关类型一样，由CoreLib中提供。

关于命名，没有直接使用Date和Time作为新API的名称，应该是因为避免混淆，因为一个DateTime.Date已经返回了一个DateTime类型的值。既然日期类型只能选择DateOnly了，那么时间类型也自然是TimeOnly啦。

DateOnly

// Without DateOnly

var d1 = DateTime.Parse("2021-11-14");

var d2 = DateTime.Parse("2021-11-14");

var isSameDate = d1.Date == d2.Date;

Assert.IsTrue(isSameDate);

// Use DateOnly

var d1 = DateOnly.Parse("2021-11-14");

var d2 = DateOnly.Parse("2021-11-14");

var isSameDate = d1 == d2;

Assert.IsTrue(isSameDate);

DateOnly使用很简单，一般使用DateOnly.FromDateTime和DateOnly.(Try)Parse生成一个DateOnly对象。需要注意的是DateOnly.Parse的传参只能是日期部分的字符串，像2021-11-14 12:34:56这样的参数是会报错的。

TimeOnly

// Without TimeOnly

var workDateTime = DateTimeOffset.Parse("09:00");

var outOfWorkDateTime = DateTimeOffset.Parse("18:00");

var workingDateTime = DateTimeOffset.Parse("10:00");

var workTime = workDateTime.TimeOfDay;

var outOfWorkTime = outOfWorkDateTime.TimeOfDay;

var workingTime = workingDateTime.TimeOfDay;

var noLate = workingTime > workTime && workingTime < outOfWorkTime;

Assert.IsTrue(noLate);

// Use TimeOnly

var workTime = TimeOnly.Parse("09:00");

var outOfWorkTime = TimeOnly.Parse("18:00");

var workingTime = TimeOnly.Parse("10:00");

var noLate = workingTime.IsBetween(workTime, outOfWorkTime);

Assert.IsTrue(noLate);

TimeOnly使用方式与DateOnly类似，不过它有个特别的TimeOnly.IsBetween方法。

Supports both "normal"

ranges such as 10:00-12:00, and ranges that span midnight such as 23:00-01:00.

Attentions

目前DateOnly和TimeOnly不被System.Text.Json和Newtonsoft.Json等库支持。

巴特西

.NET 6: New DateOnly and TimeOnly strcuts

Background and Motivation

Intro

DateOnly

TimeOnly

Attentions

References

最新文章

热门文章