DateTime.ToFileTimeUtc Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte o valor do objeto DateTime atual para uma hora de arquivo do Windows.
public:
long ToFileTimeUtc();public long ToFileTimeUtc ();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongRetornos
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.