DateTime.ToFileTimeUtc Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

Converte il valore dell'oggetto DateTime corrente in un'ora di un file di Windows.

public:
 long ToFileTimeUtc();

public long ToFileTimeUtc ();

member this.ToFileTimeUtc : unit -> int64

Public Function ToFileTimeUtc () As Long

Restituisce

Int64

Valore dell'oggetto DateTime corrente espresso come un'ora di un file di Windows.

Eccezioni

ArgumentOutOfRangeException

L'ora del file risultante rappresenta una data e un'ora prima delle 12:00 mezzanotte 1° gennaio 1601 C.E. UTC.

Commenti

Un'ora di file di Windows è un valore a 64 bit che rappresenta il numero di intervalli a 100 nanosecondi trascorsi dalle 12:00 mezzanotte, 1 gennaio 1601 A.D. (C.E.) Ora universale coordinata (UTC). Windows usa un'ora di file per registrare quando un'applicazione crea, accede o scrive in un file.

Il ToFileTimeUtc metodo usa la Kind proprietà per determinare se l'oggetto corrente DateTime è un'ora LOCALE, un'ora UTC o un tipo di tempo non specificato che viene considerato come ora UTC. Se si tratta di un'ora locale, converte l'ora in UTC prima di eseguire la conversione in un'ora file di Windows.

Note per i chiamanti

Il ToFileTimeUtc() metodo viene talvolta usato per convertire un'ora locale in formato UTC e successivamente per ripristinarlo chiamando il FromFileTimeUtc(Int64)ToLocalTime() metodo seguito dal metodo . Tuttavia, se l'ora originale rappresenta un'ora non valida nel fuso orario locale, i due valori dell'ora locale non saranno uguali. Per altre informazioni, vedere il ToLocalTime() metodo .

Vedi anche

• ToFileTime()
• Int64
• ToUniversalTime()
• GetUtcOffset(DateTime)