在.NET 6中使用DateOnly和TimeOnly

今日不可转载，可在儿童节当天或之后在公众号申请白名单。

千呼万唤始出来

在.NET 6(preview 4)中引入了两个期待已久的类型，将作为核心库的一部分。DateOnly和TimeOnly允许开发人员表示DateTime的日期或时间部分。这两个类型为值类型（struct type），可以在代码中独立处理日期或时间概念时使用，它们定义在System命名控件中，使用它们可以与数据库中允许表示相同类型数据的方式保持一致。具体来说，这些类型与SQL Server数据库中日期和时间类型可以很好的进行匹配。

注意：如果你要使用这两种类型，需要下载并安装.NET 6(preview 4)和Visual Studio 16.11（目前处于预览版中)。如果你想测试一下如何使用，可以使用LinqPad进行测试验证。

在.NET 6中使用DatetOnly类型

根据字面意思可以很容易看出它所要表达的意思。当我们需要表示一个没有时间信息的日期类型时，可以使用DateOnly。例如，我们可以在应用程序中表示某人的出生日期。在这种情况下，我们很少需要使用到DateTime类型的时间部分了。一个标准的解决方案时将时间设置为：00:00:00.000。但是使用DateOnly，我们可以更明确的表明我们想要的意图。

我们可以通过年、月、日参数构建一个DateOnly的实例。

var date = new DateOnly(2021, 5, 31);

这样，我们就创建了一个表示2021年5月31日的日期类型。在内部，DataOnly结构使用一个整数来跟踪一个有效天数的时间范围：0（映射为0001年1月1日）-3652058（映射为9999年12月31日）。

通常情况下，我们会从一个现有的DateTime类型的实例开始，希望从它创建一个DateOnly实例。为了实现这一点，我们可以调用FromDateTime方法。

var currentDateOnly = DateOnly.FromDateTime(DateTime.Now);

与现有的DateTime类型一样，我们也可以使用Parse或TryParse方法将表示日期的字符串解析为DateOnly类型，这两个方法可能会抛出异常，或返回指示成功或失败的bool值。

if (DateOnly.TryParse("28/09/1984", new CultureInfo("en-GB"), DateTimeStyles.None, out var result))
{
	Console.WriteLine($"{result.Year}-{result.Month}-{result.Day}");
}

上面的代码尝试从第一个参数（日期的字符串表示）解析日期。由于不同的国家和地区对日期的解释不同，因此日期的解析可能或受到文化的影响。在这个例子中，明确提供CultureInfo选项，以确保它使用日/月/年的格式从字符串中正确解析。
在成功解析成DateOnly实例的情况下，它将被写入控制台。再一次强调：CultureInfo选择在这里扮演着重要角色。在本例中，将使用正在运行的线程的当前区域性来确定所使用的格式。根据系统配置，在应用程序线程在en-GB下运行。因此字符串被正确格式化。在LinqPad输出结果：

我们还可以向DateOnly实例中调用AddDays、AddMonths和AddYears方法，以创建一个新的日期类型的实例。

var newDateOnly = date.AddDays(1).AddMonths(1).AddYears(1);

在.NET 6中使用TimeOnly类型

TimeOnly结构体用于表示一个与日期无关的一个时间类型。例如，想象创建一个闹钟应用程序，让用户创建一个重复出现的闹钟。在这种情况下，我们要存储一天中报警应该想起的时间，但这个时间和日期是没有关系的。
TimeOnly类型有几个构造方法重载。我认为大多数开发者会使用的且更常见的方法是允许我们创建一个可以小时分钟，小时分钟秒数、小时分钟秒数毫秒数方法的时间类型。

public TimeOnly(int hour, int minute)
public TimeOnly(int hour, int minute, int second)
public TimeOnly(int hour, int minute, int second, int millisecond)

例如，为了表示上午10：30分，我们可以创建以下TimeOnly的实例。

var startTime = new TimeOnly(10, 30);

在这里，小时采用24小时制格式，这样 1 PM 就是13时。

在内部，TimeOnly存储了一个long类型，它表示自定义时间从凌晨后经过的Ticks（100纳秒一个tick）。例如，凌晨1点时一天中的第一个小时，因此，从凌晨开始就有360亿个Tick（00:00:00.0000000）。虽然我们可以通过提供Ticks作为参数来构造TimeOnly。但这个实现细节对于一般使用来说并不是必需的。

public TimeOnly(long ticks);

在定义了开始时间之后，我们可以使用另一个TimeOnly实例定义一个结束时间为5PM。

var endTime = new TimeOnly(17, 00, 00);

现在就可以对这些TimeOnly实例进行数学操作，比如计算差。

var diff = endTime - startTime;

该操作返回类型是TimeSpan，记录了两个TimeOnly值之间相差的小时数。可以看LinqPad的输出结果。

我们可以执行的另一个检查时识别特定的TimeOnly是否在时间窗口内。例如，假设我们想要检查当前时间是否在我们定义的开始时间和结束时间之间。与DateOnly一样，我们可以使用FromDateTime静态方法将现有的DateTime转化为TimeOnly。

var currentTime = TimeOnly.FromDateTime(DateTime.Now);
var isBetween = currentTime.IsBetween(startTime, endTime);
Console.WriteLine($"Current time {(isBetween ? "is" : "is not")} between start and end");

上面的代码将输出到控制台，以确定当前时间是否在10：30（10：30 AM）和17：00（5 PM）之间。LinqPad输出的结果进行了稍微的改变，用来输出当前时间。

方法IsBetween()可以接受两个参数，正常的时间范围，如我们前面的示例中使用的范围。同样可以接受跨凌晨的时间范围，如22：00-02：00。

var startTime = new TimeOnly(22, 00);
var endTime = new TimeOnly(02, 00);
var now = new TimeOnly(23, 25);
  
var isBetween = now.IsBetween(startTime, endTime);
Console.WriteLine($"Current time {(isBetween ? "is" : "is not")} between start and end"); 
// Output = Current time is between start and end

LinqPad中的最后一行的输出内容。

TimeOnly还包括用于比较使用循环时钟的时间操作符。

var startTime = new TimeOnly(08, 00);
var endTime = new TimeOnly(09, 00);
  
Console.WriteLine($"{startTime < endTime}");
// Output = True

这段代码检查上午8点是否早于上午9点，显然是早于9点的。

总结

面向 .NET 6 的新应用程序中，如果您的数据需要独立表示日期或时间，那么 DateOnly 和 TimeOnly 值得考虑。

你喜欢这篇文章吗?觉得它有用吗?如果有，请考虑支持我，关注一下我的公众号