DateTime 構造体

  • リファレンス

定義

名前空間:
Windows.Foundation
編集

特定の時点を表します。通常、日時形式で表されます。

Javascript この型は Date オブジェクトとして表示されます。

。ネット .NET を使用してプログラミングする場合、この型は非表示になり、開発者は System.DateTimeOffset 構造体を使用する必要があります。

C++/CXFILETIME に似ていますが、重要な違いがあります。 「解説」を参照してください。

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
継承
ValueType
DateTime
属性
ContractVersionAttribute

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 値と同じですが、最大約 2,9000 C.E までの日付のみを表すことができます。負の値は、1601 年 1 月 1 日より前の間隔の数を表し、約 27,400 B.C.E に戻る日付を表すことができます。グレゴリオ暦では、 DateTimeFormatter を使用して、1 年の午前 0 時以降の日付に DateTime の文字列表現を作成できます。

UniversalTime を SYSTEMTIME に変換するには、ULARGE_INTEGERを使用して int64 値を FILETIME に変換し、FileTimeToSystemTime を使用して SYSTEMTIME を取得します。

C++/WinRT では、 DateTime は FILETIME と同じ粒度を持つという点で C++/CX に似ています。 C++/CX とは異なり、これは個別の構造体ではなく std::chrono::time_point の特殊化です。 C++/WinRT には、DateTime を FILETIME との間で変換し、time_tとの間で変換するヘルパー関数が用意されています。 これらの関数の詳細については、「 winrt::clock 構造体」を参照してください。

フィールド

UniversalTime

1601 年 1 月 1 日午前 0 時より前または後の 100 ナノ秒間隔の数としてポイント イン タイムを表す 64 ビット符号付き整数 (グレゴリオ暦に従います)。

注意

C++/WinRT では、その言語プロジェクション DateTime は std::chrono::time_point の特殊化であるため、このフィールドは存在しません。 生整数値が必要な場合は、 time_point::time_since_epoch を使用して std::chrono::d uration を取得し、その count メソッドを使用して生カウントを取得します。

適用対象

こちらもご覧ください