Freigeben über


DateTime.ToFileTimeUtc Methode

Definition

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

public:
 long ToFileTimeUtc();
public long ToFileTimeUtc ();
member this.ToFileTimeUtc : unit -> int64
Public Function ToFileTimeUtc () As Long

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:

Weitere Informationen