DateTime.ToFileTimeUtc DateTime.ToFileTimeUtc DateTime.ToFileTimeUtc DateTime.ToFileTimeUtc Method

Definición

Convierte el valor del objeto DateTime actual en una hora de archivo de Windows.Converts the value of the current DateTime object to a Windows file time.

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

Devoluciones

El valor del objeto DateTime actual expresado como una hora de archivo de Windows.The value of the current DateTime object expressed as a Windows file time.

Excepciones

La hora del archivo resultante representaría una fecha y hora antes de la medianoche del 1 de enero de 1601 e. c.The resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. UTC.UTC.

Comentarios

Una hora de archivo de Windows es un valor de 64 bits que representa el número de intervalos de 100 segundos que han transcurrido 12:00 desde la medianoche del 1 de enero de 1601 D.C.A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Hora universal coordinada (UTC).(C.E.) Coordinated Universal Time (UTC). Windows usa una hora de archivo para grabar cuando una aplicación crea, accede o escribe en un archivo.Windows uses a file time to record when an application creates, accesses, or writes to a file.

El ToFileTimeUtc método utiliza la Kind propiedad para determinar si el objeto DateTime actual es una hora local, una hora UTC o un tipo de tiempo no especificado que se trata como una hora UTC.The ToFileTimeUtc method uses the Kind property to determine whether the current DateTime object is a local time, a UTC time, or an unspecified kind of time which is treated as a UTC time. Si es una hora local, convierte la hora a UTC antes de realizar la conversión a una hora de archivo de Windows.If it is a local time, it converts the time to UTC before performing the conversion to a Windows file time.

Notas a los autores de las llamadas

A ToFileTimeUtc() veces, el método se usa para convertir una hora local a UTC y, posteriormente, para restaurarlo FromFileTimeUtc(Int64) llamando al método seguido ToLocalTime() del método.The ToFileTimeUtc() method is sometimes used to convert a local time to UTC, and subsequently to restore it by calling the FromFileTimeUtc(Int64) method followed by the ToLocalTime() method. 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.However, if the original time represents an invalid time in the local time zone, the two local time values will not be equal. Para obtener más información, vea ToLocalTime() el método.For additional information, see the ToLocalTime() method.

Se aplica a

Consulte también: