Função GetTimeZoneInformationForYear (timezoneapi.h)
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 |