Share via

Função GetTimeZoneInformationForYear (timezoneapi.h)

  • Artigo

Recupera as configurações de fuso horário para o ano e o fuso horário especificados. Essas configurações controlam as traduções entre o UTC (Tempo Universal Coordenado) e a hora local.

Sintaxe

BOOL GetTimeZoneInformationForYear(
  [in]           USHORT                         wYear,
  [in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  [out]          LPTIME_ZONE_INFORMATION        ptzi
);

Parâmetros

[in] wYear

O ano para o qual as configurações de fuso horário devem ser recuperadas. O parâmetro wYear deve ser um valor de hora local.

[in, optional] pdtzi

Um ponteiro para uma estrutura DYNAMIC_TIME_ZONE_INFORMATION que especifica o fuso horário. Para preencher esse parâmetro, chame EnumDynamicTimeZoneInformation com o índice do fuso horário desejado. Se esse parâmetro for NULL, o fuso horário atual será usado.

[out] ptzi

Um ponteiro para uma estrutura TIME_ZONE_INFORMATION que recebe as configurações de fuso horário.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O parâmetro wYear é considerado um valor de hora local. Se a hora local estiver próxima da transição entre o ano antigo e o ano novo (00:00:00 de 1º de janeiro), passar um ano UTC para a função GetTimeZoneInformationForYear poderá fazer com que a função retorne as configurações de fuso horário para o ano errado.

Os membros StandardName e DaylightName da estrutura de TIME_ZONE_INFORMATION resultante são localizados de acordo com o idioma de interface do usuário padrão do usuário atual.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista com SP1 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho timezoneapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

DYNAMIC_TIME_ZONE_INFORMATION

Hora Local

TIME_ZONE_INFORMATION

Funções de tempo