DateTime.ToFileTimeUtc Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

DateTime.cs

Convierte el valor del objeto DateTime actual en una hora de archivo de Windows.

public:
 long ToFileTimeUtc();

public long ToFileTimeUtc ();

member this.ToFileTimeUtc : unit -> int64

Public Function ToFileTimeUtc () As Long

Devoluciones

Int64

El valor del objeto DateTime actual expresado como una hora de archivo de Windows.

Excepciones

ArgumentOutOfRangeException

La hora del archivo resultante representaría una fecha y hora anteriores a las 12:00 medianoche del 1 de enero de 1601 C.E. UTC.

Comentarios

Una hora de archivo de Windows es un valor de 64 bits que representa el número de intervalos de 100 nanosegundos que han transcurrido desde la medianoche de 12:00, 1 de enero de 1601 A.D. (C.E.) Hora universal coordinada (UTC). Windows usa un tiempo de archivo para registrar cuando una aplicación crea, accede o escribe en un archivo.

El ToFileTimeUtc método usa la Kind propiedad para determinar si el objeto actual DateTime es una hora local, una hora UTC o un tipo de hora no especificado que se trata como una hora UTC. Si es una hora local, convierte la hora a UTC antes de realizar la conversión a una hora del archivo de Windows.

Notas a los autores de las llamadas

El ToFileTimeUtc() método se usa a veces para convertir una hora local a UTC y, posteriormente, para restaurarla llamando al FromFileTimeUtc(Int64) método seguido del ToLocalTime() método . Sin embargo, si la hora original representa una hora no válida en la zona horaria local, los dos valores de hora local no serán iguales. Para obtener más información, consulte el ToLocalTime() método .

Consulte también

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