Compartir a través de


Función SystemTimeToFileTime (timezoneapi.h)

Convierte una hora del sistema en formato de hora de archivo. La hora del sistema se basa en la hora universal coordinada (UTC).

Sintaxis

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

Parámetros

[in] lpSystemTime

Puntero a una estructura SYSTEMTIME que contiene la hora del sistema que se va a convertir de UTC a formato de hora de archivo.

Se omite el miembro wDayOfWeek de la estructura SYSTEMTIME .

[out] lpFileTime

Puntero a una estructura FILETIME para recibir la hora del sistema convertida.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Nota

Un valor devuelto False puede indicar que la estructura SYSTEMTIME pasada representa una fecha no válida. Algunas situaciones, como el día adicional agregado en un año bisiesto, pueden dar lugar a que la lógica de la aplicación cree inesperadamente una fecha no válida. Para obtener más información sobre cómo evitar estos problemas, consulte Preparación de año bisiesto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado timezoneapi.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

DosDateTimeToFileTime

FILETIME

FileTimeToDosDateTime

FileTimeToSystemTime

SYSTEMTIME

Hora del sistema

Funciones de hora