Función GetTimeZoneInformationForYear (timezoneapi.h)

  • Artículo

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

Vea también

DYNAMIC_TIME_ZONE_INFORMATION

Hora local

TIME_ZONE_INFORMATION

Funciones de hora