DateTime.ToFileTimeUtc Methode
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.
Konvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.
public:
long ToFileTimeUtc();public long ToFileTimeUtc ();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongGibt 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.
