DateTime Struktur
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 DateTimeOffsetvar 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 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. |