DateTime Struktur

Definition

Stellt einen Zeitpunkt dar, der üblicherweise als Datum und Uhrzeit ausgedrückt wird.

Javascript Dieser Typ wird als Date-Objekt angezeigt.

.NET Bei der Programmierung mit .NET ist dieser Typ ausgeblendet, und Entwickler sollten die System.DateTimeOffset-Struktur verwenden.

C++/CX Ähnlich wie FILETIME , aber mit wichtigen Unterschieden. Siehe Hinweise.

C++/WinRT Dieser Typ ist eine Spezialisierung von std::chrono::time_point. Siehe Hinweise.

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
Vererbung
DateTime
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (eingeführt in v1.0)

Hinweise

JavaScript- und Microsoft .NET-Sprachen verwenden diesen Typ nicht direkt. In JavaScript wird eine DateTime als Date-Objekt projiziert, und in Microsoft .NET wird es als System.DateTimeOffset projiziert. Jede Sprache behandelt die Konvertierung transparent in die Granularitäts- und Datumsbereiche für die jeweilige Sprache.

In Visual C++-Komponentenerweiterungen (C++/CX) weist ein DateTime.UniversalTime-Wert dieselbe Granularität wie eine FILETIME (100-Nanosekunden-Intervalle) auf. Für positive Werte ist ein DateTime.UniversalTime-Wert mit einem FILETIME-Wert identisch, obwohl es nur Datumsangaben bis zu ca. 29000 C.E darstellen kann. Ein negativer Wert stellt die Anzahl der Intervalle vor dem 1. Januar 1601 dar und kann Datumsangaben zurück auf etwa 27.400 B.C.E darstellen. Für den gregorianischen Kalender können Sie einen DateTimeFormatter verwenden, um Zeichenfolgendarstellungen einer DateTime für Datumsangaben nach Mitternacht am Jahr 1 C.E zu erstellen.

Um die UniversalTime in SYSTEMTIME zu konvertieren, verwenden Sie ULARGE_INTEGER, um den Int64-Wert in FILETIME zu konvertieren, und verwenden Sie dann FileTimeToSystemTime, um SYSTEMTIME abzurufen.

In C++/WinRT ähnelt DateTime C++/CX darin, dass sie dieselbe Granularität wie eine FILETIME aufweist. Im Gegensatz zu C++/CX ist es eine Spezialisierung von std::chrono::time_point anstelle einer eindeutigen Struktur. C++/WinRT bietet Hilfsfunktionen zum Konvertieren von DateTime in und von FILETIME und von time_t. Weitere Informationen zu diesen Funktionen finden Sie unter winrt::uhr-Struktur.

Felder

UniversalTime

Eine 64-Bit-ganzzahl, die einen Punkt darstellt, als die Anzahl der 100-Nanosekundenintervalle vor oder nach Mitternacht am 1. Januar 1601 (gemäß gregorianischem Kalender).

Hinweis

In C++/WinRT ist dieses Feld nicht vorhanden, da in dieser Sprachprojektion DateTime eine Spezialisierung von std::chrono::time_point ist. Wenn Sie den unformatierten ganzzahligen Wert benötigen, verwenden Sie time_point::time_since_epoch , um eine std::chrono::d uration abzurufen, und verwenden Sie die Anzahlmethode , um die rohe Anzahl abzurufen.

Gilt für:

Siehe auch