Función GetTimeZoneInformation (timezoneapi.h)

Artículo
08/26/2023

Recupera la configuración de zona horaria actual. Esta configuración controla las traducciones entre la hora universal coordinada (UTC) y la hora local.

Para admitir límites para el horario de verano que cambian de año a año, use la función GetDynamicTimeZoneInformation o GetTimeZoneInformationForYear .

Sintaxis

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Parámetros

[out] lpTimeZoneInformation

Puntero a una estructura de TIME_ZONE_INFORMATION para recibir la configuración actual.

Valor devuelto

Si la función se ejecuta correctamente, devuelve uno de los valores siguientes.

Código o valor devuelto	Descripción
TIME_ZONE_ID_UNKNOWN 0	El horario de verano no se usa en la zona horaria actual, ya que no hay fechas de transición ni ajuste automático para el horario de verano está deshabilitado.
TIME_ZONE_ID_STANDARD 1	El sistema funciona en el intervalo cubierto por el miembro StandardDate de la estructura TIME_ZONE_INFORMATION .
TIME_ZONE_ID_DAYLIGHT 2	El sistema funciona en el intervalo cubierto por el miembro DaylightDate de la estructura TIME_ZONE_INFORMATION .

Si se produce un error en la función por otros motivos, como un error de memoria insuficiente, devuelve TIME_ZONE_ID_INVALID. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Todas las traducciones entre la hora UTC y la hora local se basan en la fórmula siguiente:

UTC = hora local + sesgo

El sesgo es la diferencia, en minutos, entre la hora UTC y la hora local.

Los miembros StandardName y DaylightName de la estructura de TIME_ZONE_INFORMATION resultante se localizan según el idioma de interfaz de usuario predeterminado del usuario actual.

Ejemplos

Para obtener un ejemplo, vea SetTimeZoneInformation.

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