DateTime Struktur

  • Referenz

Definition

Namespace:
Windows.Foundation
Bearbeiten

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

Javascript Dieser Typ wird als Date-Objekt angezeigt.

.NETTO Beim Programmieren 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
ValueType
DateTime
Attribute
ContractVersionAttribute

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 ein DateTime-Objekt als Date-Objekt projiziert, und in Microsoft .NET wird es als System.DateTimeOffset projiziert. Jede Sprache verarbeitet die Konvertierung in den Granularitäts- und Datumsbereichen für die jeweilige Sprache transparent.

In Visual C++-Komponentenerweiterungen (C++/CX) weist ein DateTime.UniversalTime-Wert die gleiche Granularität wie ein FILETIME-Wert (Intervalle von 100 Nanosekunden) auf. Bei positiven Werten ist ein DateTime.UniversalTime-Wert mit einem FILETIME-Wert identisch, kann jedoch nur Datumsangaben bis ca. 29.000 C.E. darstellen. Ein negativer Wert stellt die Anzahl der Intervalle vor dem 1. Januar 1601 dar und kann auf etwa 27.400 v. Chr. zurückgehen. Für den gregorianischen Kalender können Sie einen DateTimeFormatter verwenden, um Zeichenfolgendarstellungen einer DateTime für Datumsangaben nach Mitternacht im Jahr 1 C.E. zu erstellen.

Um 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 ist DateTime ähnlich wie C++/CX, da es die gleiche Granularität wie eine FILETIME aufweist. Im Gegensatz zu C++/CX ist es eine Spezialisierung von std::chrono::time_point und nicht eine eindeutige Struktur. C++/WinRT bietet Hilfsfunktionen zum Konvertieren von DateTime in und aus FILETIME und in und von time_t. Weitere Informationen zu diesen Funktionen finden Sie unter winrt::clock-Struktur.

Felder

UniversalTime

Eine 64-Bit-Ganzzahl mit Vorzeichen, die einen Zeitpunkt als Anzahl von 100 Nanosekundenintervallen vor oder nach Mitternacht am 1. Januar 1601 darstellt (gemäß dem gregorianischen Kalender).

Hinweis

In C++/WinRT ist dieses Feld nicht vorhanden, da dateTime in dieser Sprachprojektion 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 zugehörigen count-Methode , um die unformatierte Anzahl abzurufen.

Gilt für:

Weitere Informationen