Sdílet prostřednictvím

DateTime.ToFileTimeUtc Metoda

Definice

Obor názvů:
System
Sestavení:
mscorlib.dll, System.Runtime.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
DateTime.cs
Zdroj:
DateTime.cs
Zdroj:
DateTime.cs
Zdroj:
DateTime.cs
Zdroj:
DateTime.cs

Převede hodnotu aktuálního DateTime objektu na čas souboru systému Windows.

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

Návraty

Int64

Hodnota aktuálního DateTime objektu vyjádřená jako čas souboru systému Windows.

Výjimky

ArgumentOutOfRangeException

Výsledný čas souboru by představoval datum a čas před 12:00 půlnocí 1. ledna 1601 C.E. UTC.

Poznámky

Čas souboru Systému Windows je 64bitová hodnota, která představuje počet intervalů 100 nanosekund, které uplynuly od 12:00 půlnoci, 1. ledna 1601 A.D. (C.E.) Koordinovaný univerzální čas (UTC). Systém Windows používá k zaznamenávání času při vytváření, přístupu nebo zápisu aplikace do souboru.

Metoda ToFileTimeUtc používá Kind vlastnost k určení, zda je aktuální DateTime objekt místní čas, čas UTC nebo nespecifikovaný druh času, který je považován za čas UTC. Pokud se jedná o místní čas, převede čas na UTC před provedením převodu na čas souboru systému Windows.

Poznámky pro volající

Metoda ToFileTimeUtc() se někdy používá k převodu místního času na UTC a následně k jeho obnovení voláním FromFileTimeUtc(Int64) metody následované metodou ToLocalTime() . Pokud však původní čas představuje neplatný čas v místním časovém pásmu, nebudou se tyto dvě místní časové hodnoty rovnat. Další informace najdete v ToLocalTime() metodě.

Platí pro

Viz také