Auf Englisch lesen

Freigeben über


DateTime.ToFileTimeUtc Methode

Definition

Konvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.

public long ToFileTimeUtc();

Gibt zurück

Der Wert des aktuellen DateTime-Objekts als Windows-Dateizeit.

Ausnahmen

Die resultierende Dateizeit würde ein Datum und eine Uhrzeit vor 12:00 Uhr Mitternacht 1. Januar 1601 C.E. UTC darstellen.

Hinweise

Eine Windows-Dateizeit ist ein 64-Bit-Wert, der die Anzahl der Intervalle von 100 Nanosekunden darstellt, die seit 12:00 Uhr am 1. Januar 1601 n. Chr. (C.E.) verstrichen sind. Koordinierte Weltzeit (UTC). Windows verwendet eine Dateizeit, um aufzuzeichnen, wann eine Anwendung eine Datei erstellt, darauf zugreift oder in diese schreibt.

Die ToFileTimeUtc -Methode verwendet die Kind -Eigenschaft, um zu bestimmen, ob das aktuelle DateTime Objekt eine Ortszeit, eine UTC-Zeit oder eine nicht angegebene Art von Zeit ist, die als UTC-Zeit behandelt wird. Wenn es sich um eine Ortszeit handelt, wird die Uhrzeit in UTC konvertiert, bevor die Konvertierung in eine Windows-Dateizeit durchgeführt wird.

Hinweise für Aufrufer

Die ToFileTimeUtc() -Methode wird manchmal verwendet, um eine lokale Zeit in UTC zu konvertieren und anschließend durch Aufrufen der FromFileTimeUtc(Int64) -Methode gefolgt von der ToLocalTime() -Methode wiederherzustellen. Wenn die ursprüngliche Zeit jedoch eine ungültige Uhrzeit in der lokalen Zeitzone darstellt, sind die beiden Lokalen Zeitwerte nicht gleich. Weitere Informationen finden Sie unter der ToLocalTime() Methode.

Gilt für:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Weitere Informationen