.NET 6新特性试用 | DateOnly和TimeOnly类型

Posted 2021-12-29 dotNET跨平台

前言

在.NET 6之前，没有方法来直接表示没有时间的日期（比如生日）或者没有日期的一天中的时间（比如闹钟）。

虽然我们可以使用DateTime类和TimeSpan类来代替，但是实际使用中会存在一些问题：

var dateOnly = new DateTime(2021, 10, 1);
//输出
2021/10/1 0:00:00
//问题：还是有时间，并不能代表0点出生

var timeOnly = new TimeSpan(11, 22, 0).Add(TimeSpan.FromHours(24));
//输出
1.11:22:00
//问题：过了24小时，应该还是当前时间，实际带了天数

因此，.Net 6引入了DateOnly和TimeOnly结构，可以存储日期和时间

Demo

1.创建实例

我们可以直接创建DateOnly或者TimeOnly的实例：

var dateOnly = new DateOnly(2021, 10, 1);
//输出
10/1/2021

var timeOnly = new TimeOnly(11, 22, 0);
//输出
11:22 AM

还可以使用FromDateTime方法从DateTime实例中生成：

var datetime = new DateTime(2021, 10, 1, 10, 1, 0);

var dateOnly = DateOnly.FromDateTime(datetime);

var timeOnly = TimeOnly.FromDateTime(datetime);

还可以使用FromTimeSpan方法从TimeSpan实例中生成TimeOnly：

var timeSpan = new TimeSpan(11, 22, 0);
 
var timeOnly = TimeOnly.FromTimeSpan(timeSpan);

2.类型转换

反之，可以使用ToDateTime方法将DateOnly实例转换成DateTime：

var dateOnly = new DateOnly(2021, 10, 1);

var timeOnly = new TimeOnly(11, 22, 0);

var datetime = dateOnly.ToDateTime(timeOnly);
//输出
10/1/2021 11:22:00 AM

可以看到，必须同时带上TimeOnly实例才能转换。

也可以使用ToTimeSpan方法将TimeOnly实例转换成TimeSpan：

var timeOnly = new TimeOnly(11, 22, 0);

var timeSpan = timeOnly.ToTimeSpan();
//输出
11:22:00

3.操作

DateOnly和TimeOnly类型还提供了比较运算符（例如<和>）和AddXXX方法进行操作：

var noon = new TimeOnly(12, 0);
if (now < noon)

    //早上
    ...


dateOnly = dateOnly.AddDays(7);

timeOnly = timeOnly.AddHours(24);

需要注意的是，仅仅TimeOnly类型支持-运算符，获得TimeSpan时间间隔。

结论

DateOnly和TimeOnly的引入并不意味着DateTime将不再有用，只是将它们用在不同场景。

如果你觉得这篇文章对你有所启发，请帮忙点个赞或者在看