Función SystemTimeToTzSpecificLocalTime (timezoneapi.h)

Artículo
03/05/2024

Convierte una hora en hora universal coordinada (UTC) en la hora local correspondiente de una zona horaria especificada.

Sintaxis

BOOL SystemTimeToTzSpecificLocalTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpUniversalTime,
  [out]          LPSYSTEMTIME                lpLocalTime
);

Parámetros

[in, optional] lpTimeZoneInformation

Puntero a una estructura de TIME_ZONE_INFORMATION que especifica la zona horaria de interés.

Si lpTimeZone es NULL, la función usa la zona horaria activa actualmente.

[in] lpUniversalTime

Puntero a una estructura SYSTEMTIME que especifica la hora UTC que se va a convertir. La función convierte esta hora universal en la hora local correspondiente de la zona horaria especificada.

[out] lpLocalTime

Puntero a una estructura SYSTEMTIME que recibe la hora local.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero y la función establece los miembros de la estructura SYSTEMTIME a la que apunta lpLocalTime en los valores de hora local adecuados.

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

Comentarios

La función SystemTimeToTzSpecificLocalTime tiene en cuenta si el horario de verano (DST) está en vigor para la hora local a la que se va a convertir la hora del sistema.

La función SystemTimeToTzSpecificLocalTime puede calcular la hora local incorrectamente en las condiciones siguientes:

La zona horaria usa un desplazamiento UTC diferente para los años antiguos y nuevos.
La hora UTC que se va a convertir y la hora local calculada se encuentra en años diferentes.

Ejemplos

Para obtener un ejemplo, consulte Recuperación de la hora de Last-Write.

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