Partilhar via


DateTime.ToFileTimeUtc Método

Definição

Converte o valor do objeto DateTime atual para uma hora de arquivo do Windows.

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

Retornos

Int64

O valor do objeto DateTime atual expresso como uma hora de arquivo do Windows.

Exceções

A hora do arquivo resultante representaria uma data e hora antes da meia-noite, 12:00, de 1º de janeiro de 1601, C.E. UTC.

Comentários

Uma hora de arquivo do Windows é um valor de 64 bits que representa o número de intervalos de 100 nanossegundos desde a meia-noite de 12h00, 1º de janeiro de 1601 A.D. (C.E.) Tempo Universal Coordenado (UTC). O Windows usa uma hora de arquivo a ser registrada quando um aplicativo cria, acessa ou grava em um arquivo.

O ToFileTimeUtc método usa a Kind propriedade para determinar se o DateTime objeto atual é uma hora local, uma hora UTC ou um tipo de tempo não especificado que é tratado como uma hora UTC. se for uma hora local, ele converterá a hora em UTC antes de executar a conversão em uma Windows hora do arquivo.

Notas aos Chamadores

O ToFileTimeUtc() método às vezes é usado para converter uma hora local em UTC e, subsequentemente, restaurá-lo chamando o FromFileTimeUtc(Int64) método seguido pelo ToLocalTime() método. No entanto, se a hora original representar uma hora inválida no fuso horário local, os dois valores de hora local não serão iguais. Para obter informações adicionais, consulte o ToLocalTime() método.

Aplica-se a

Confira também