DateTime 结构

定义

表示某个时刻,通常以日期和当天的时间表示。

Javascript 此类型显示为 Date 对象。

.NET 使用 .NET 进行编程时,此类型处于隐藏状态,开发人员应使用 System.DateTimeOffset 结构。

C++/CX 类似于 FILETIME ,但存在重要差异。 请参阅“备注”。

C++/WinRT 此类型是 std::chrono::time_point 的专用化。 请参阅“备注”。

public value class DateTime
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct time_point
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct DateTimeOffset
var dateTime = {
universalTime : /* Your value */
}
Public Structure DateTimeOffset
继承
DateTime
属性

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.FoundationContract (在 v1.0 中引入)

注解

JavaScript 和 Microsoft .NET 语言不直接使用此类型。 在 JavaScript 中,DateTime 投影为 Date 对象,在 Microsoft .NET 中,它投影为 System.DateTimeOffset。 每个语言以透明方式处理对相应语言的粒度和日期范围的转换。

在 Visual C++ 组件扩展 (C++/CX) 中, DateTime.UniversalTime 值与 FILETIME (100 纳秒间隔) 的粒度相同。 对于正值, DateTime.UniversalTime 值与 FILETIME 值相同,尽管它只能表示最多 29000 C.E 的日期。负值表示 1601 年 1 月 1 日之前的间隔数,并表示日期可追溯到大约 27,400 B.C.E。对于公历,可以使用 DateTimeFormatter 在 C.E 午夜后为日期创建 DateTime 的字符串表示形式。

若要将 UniversalTime 转换为 SYSTEMTIME,请使用 ULARGE_INTEGERint64 值转换为 FILETIME,然后使用 FileTimeToSystemTime 获取 SYSTEMTIME

在 C++/WinRT 中, DateTime 类似于 C++/CX,因为它的粒度与 FILETIME 相同。 与 C++/CX 不同,它是 std::chrono::time_point 的专用化,而不是不同的结构。 C++/WinRT 提供帮助程序函数,用于将 DateTimeFILETIMEtime_t 进行转换。 有关这些函数的详细信息,请参阅 winrt::clock 结构

字段

UniversalTime

根据公历) ,160 (1 年 1 月 1 日午夜或午夜之后,64 位带符号整数表示时间点作为 100 纳秒间隔的数目。

注意

在 C++/WinRT 中,此字段不存在,因为在该语言投影 中,DateTimestd::chrono::time_point的专用化。 如果需要原始整数值,请使用 time_point::time_since_epoch 获取 std::chrono::d uration,并使用其 count 方法获取原始 计数

适用于

另请参阅