前言
在.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/2021var 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:003.操作
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将不再有用,只是将它们用在不同场景。
如果你觉得这篇文章对你有所启发,请帮忙点个赞或者在看