Função GetTimeZoneInformation (timezoneapi.h)
Recupera as configurações atuais de fuso horário. Essas configurações controlam as traduções entre o UTC (Tempo Universal Coordenado) e a hora local.
Para dar suporte a limites para o horário de verão que mudam de ano para ano, use a função GetDynamicTimeZoneInformation ou GetTimeZoneInformationForYear .
Sintaxe
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
Parâmetros
[out] lpTimeZoneInformation
Um ponteiro para uma estrutura TIME_ZONE_INFORMATION para receber as configurações atuais.
Retornar valor
Se a função for bem-sucedida, ela retornará um dos valores a seguir.
| Valor/código retornado | Descrição |
|---|---|
|
O horário de verão não é usado no fuso horário atual, pois não há datas de transição ou o ajuste automático para o horário de verão está desabilitado. |
|
O sistema está operando no intervalo coberto pelo membro StandardDate da estrutura TIME_ZONE_INFORMATION . |
|
O sistema está operando no intervalo coberto pelo membro DaylightDate da estrutura TIME_ZONE_INFORMATION . |
Se a função falhar por outros motivos, como um erro de memória insuficiente, ela retornará TIME_ZONE_ID_INVALID. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Todas as traduções entre a hora UTC e a hora local são baseadas na seguinte fórmula:
UTC = hora local + viés
O viés é a diferença, em minutos, entre a hora UTC e a hora local.
Os membros StandardName e DaylightName da estrutura de TIME_ZONE_INFORMATION resultante são localizados de acordo com a linguagem de interface do usuário padrão do usuário atual.
Exemplos
Para obter um exemplo, consulte SetTimeZoneInformation.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | timezoneapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |