Función GetTimeZoneInformation (timezoneapi.h)
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 |
|---|---|
|
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. |
|
El sistema funciona en el intervalo cubierto por el miembro StandardDate de la estructura TIME_ZONE_INFORMATION . |
|
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 |