DateTime.ToFileTimeUtc Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
mscorlib.dll

převede hodnotu aktuálního DateTime objektu na čas Windows souboru.

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 Windows souboru

Výjimky

ArgumentOutOfRangeException

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

Poznámky

Čas souboru systému Windows je 64bitová hodnota reprezentující počet 100nanosekundových intervalů, které uplynuly od půlnoci (0:00) 1. ledna 1601 n.l. 0001 Koordinovaný světový čas (UTC). Systém Windows používá k záznamu okamžiku, kdy aplikace vytvoří, přistoupí nebo zapíše do souboru, čas souboru.

ToFileTimeUtcMetoda používá Kind vlastnost k určení, zda DateTime je aktuální objekt místní čas, čas UTC nebo nespecifikovaný typ času, který je považován za čas UTC. pokud je místní čas, převede čas na čas UTC před provedením převodu na Windows čas souboru.

Poznámky pro volající

ToFileTimeUtc()Metoda je někdy používána k převodu místního času na čas UTC a následně k jejímu obnovení voláním FromFileTimeUtc(Int64) metody následované ToLocalTime() metodou. Nicméně pokud původní čas představuje neplatný čas v místním časovém pásmu, nebudou hodnoty obou místních časů stejné. Další informace naleznete v ToLocalTime() metodě.

Platí pro

Viz také