Función SystemTimeToTzSpecificLocalTime (timezoneapi.h)
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 |