Función GetTimeZoneInformationForYear (timezoneapi.h)
Recupera la configuración de zona horaria para el año y la zona horaria especificados. Esta configuración controla las traducciones entre la hora universal coordinada (UTC) y la hora local.
Sintaxis
BOOL GetTimeZoneInformationForYear(
[in] USHORT wYear,
[in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
[out] LPTIME_ZONE_INFORMATION ptzi
);
Parámetros
[in] wYear
Año para el que se va a recuperar la configuración de zona horaria. El parámetro wYear debe ser un valor de hora local.
[in, optional] pdtzi
Puntero a una estructura DYNAMIC_TIME_ZONE_INFORMATION que especifica la zona horaria. Para rellenar este parámetro, llame a EnumDynamicTimeZoneInformation con el índice de la zona horaria que desee. Si este parámetro es NULL, se usa la zona horaria actual.
[out] ptzi
Puntero a una estructura TIME_ZONE_INFORMATION que recibe la configuración de zona horaria.
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.
Comentarios
Se supone que el parámetro wYear es un valor de hora local. Si la hora local está cerca de la transición entre el año anterior y el año nuevo (00:00:00 1 de enero), pasar un año UTC a la función GetTimeZoneInformationForYear puede hacer que la función devuelva la configuración de zona horaria para el año incorrecto.
Los miembros StandardName y DaylightName de la estructura de TIME_ZONE_INFORMATION resultante se localizan según el idioma de la interfaz de usuario predeterminado del usuario actual.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista con SP1 [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | timezoneapi.h (incluir Windows.h) |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |