DateTime.ToFileTimeUtc Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Converte o valor do objeto atual DateTime para um tempo de ficheiro Windows.
public:
long ToFileTimeUtc();public long ToFileTimeUtc();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongDevoluções
O valor do objeto atual DateTime expresso como um tempo de ficheiro Windows.
Exceções
A hora resultante do ficheiro representaria uma data e hora antes das 12:00 da meia-noite de 1 de janeiro de 1601 C.E. UTC.
Observações
Um tempo de ficheiro Windows é um valor de 64 bits que representa o número de intervalos de 100 nanossegundos que decorreram desde as 12:00 da meia-noite de 1 de janeiro de 1601 d.C. (d.C.) Tempo Universal Coordenado (UTC). O Windows utiliza um tempo de ficheiro para registar quando uma aplicação cria, acede ou escreve num ficheiro.
O ToFileTimeUtc método utiliza a Kind propriedade para determinar se o objeto atual DateTime é uma hora local, uma hora UTC ou um tipo de tempo não especificado, que é tratado como hora UTC. Se for uma hora local, converte a hora para UTC antes de realizar a conversão para um tempo de ficheiro Windows.
Notas para Chamadores
O ToFileTimeUtc() método é por vezes usado para converter uma hora local para UTC e, posteriormente, para a restaurar 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 locais de hora não serão iguais. Para informações adicionais, consulte o ToLocalTime() método.
