Compartilhar via


estrutura TIME_ZONE_INFORMATION (timezoneapi.h)

Especifica as configurações de um fuso horário.

Sintaxe

typedef struct _TIME_ZONE_INFORMATION {
  LONG       Bias;
  WCHAR      StandardName[32];
  SYSTEMTIME StandardDate;
  LONG       StandardBias;
  WCHAR      DaylightName[32];
  SYSTEMTIME DaylightDate;
  LONG       DaylightBias;
} TIME_ZONE_INFORMATION, *PTIME_ZONE_INFORMATION, *LPTIME_ZONE_INFORMATION;

Membros

Bias

A diferença atual para conversão da hora local neste computador, em minutos. O desvio é a diferença, em minutos, entre o UTC (Tempo Universal Coordenado) e a hora local. Todas as traduções entre UTC e hora local são baseadas na seguinte fórmula:

UTC = hora local + desvio

Esse membro é necessário.

StandardName[32]

Uma descrição para o horário padrão. Por exemplo, "EST" pode indicar Hora Padrão do Leste. A cadeia de caracteres será retornada inalterada pela função GetTimeZoneInformation . Essa cadeia de caracteres pode estar vazia.

StandardDate

Uma estrutura SYSTEMTIME que contém uma data e hora local quando ocorre a transição do horário de verão para o horário padrão nesse sistema operacional. Se o fuso horário não der suporte ao horário de verão ou se o chamador precisar desabilitar o horário de verão, o membro wMonth na estrutura SYSTEMTIME deverá ser zero. Se essa data for especificada, o membro DaylightDate dessa estrutura também deverá ser especificado.

Caso contrário, o sistema pressupõe que os dados de fuso horário são inválidos e nenhuma alteração será aplicada.

Para selecionar o dia correto no mês, defina o membro wYear como zero, os membros wHour e wMinute para o tempo de transição, o membro wDayOfWeek para o dia da semana apropriado e o membro wDay para indicar a ocorrência do dia da semana dentro do mês (1 a 5, em que 5 indica a ocorrência final durante o mês se esse dia da semana não ocorrer 5 vezes).

Usando essa notação, especifique 02:00 no primeiro domingo de abril da seguinte maneira: wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1. Especifique 02:00 na última quinta-feira de outubro da seguinte maneira: wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5.

Se o membro wYear não for zero, a data de transição será absoluta; ocorrerá apenas uma vez. Caso contrário, é uma data relativa que ocorre anualmente.

StandardBias

O valor de desvio a ser usado durante traduções de horário local que ocorrem durante o horário padrão. Esse membro será ignorado se um valor para o membro StandardDate não for fornecido.

Esse valor é adicionado ao valor do membro Bias para formar o desvio usado durante o tempo padrão. Na maioria dos fusos horários, o valor desse membro é zero.

DaylightName[32]

Uma descrição do horário de verão. Por exemplo, "PDT" pode indicar o Horário de Verão do Pacífico. A cadeia de caracteres será retornada inalterada pela função GetTimeZoneInformation . Essa cadeia de caracteres pode estar vazia.

DaylightDate

Uma estrutura SYSTEMTIME que contém uma data e hora local quando ocorre a transição do horário padrão para o horário de verão nesse sistema operacional. Se o fuso horário não der suporte ao horário de verão ou se o chamador precisar desabilitar o horário de verão, o membro wMonth na estrutura SYSTEMTIME deverá ser zero. Se essa data for especificada, o membro StandardDate nessa estrutura também deverá ser especificado.

Caso contrário, o sistema pressupõe que os dados de fuso horário são inválidos e nenhuma alteração será aplicada.

Para selecionar o dia correto no mês, defina o membro wYear como zero, os membros wHour e wMinute para o tempo de transição, o membro wDayOfWeek para o dia da semana apropriado e o membro wDay para indicar a ocorrência do dia da semana dentro do mês (1 a 5, em que 5 indica a ocorrência final durante o mês se esse dia da semana não ocorrer 5 vezes).

Se o membro wYear não for zero, a data de transição será absoluta; ocorrerá apenas uma vez. Caso contrário, é uma data relativa que ocorre anualmente.

DaylightBias

O valor de desvio a ser usado durante traduções de horário local que ocorrem durante o horário de verão. Esse membro será ignorado se um valor para o membro DaylightDate não for fornecido.

Esse valor é adicionado ao valor do membro Bias para formar o desvio usado durante o horário de verão. Na maioria dos fusos horários, o valor desse membro é –60.

Comentários

As configurações para cada fuso horário são armazenadas na seguinte chave do Registro:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name

Cada entrada de fuso horário inclui os seguintes valores do Registro.

Valor do Registro Tipo Descrição
Exibição REG_SZ O nome para exibição.
Dlt REG_SZ A descrição do horário de verão.
MUI_Display REG_SZ O nome de exibição como uma cadeia de caracteres do formulário @path,-stringID[;comentário]. Para obter mais informações, consulte MUI.
MUI_Dlt REG_SZ A descrição do horário de verão como uma cadeia de caracteres do formulário @path,-stringID[;comentário].
MUI_Std REG_SZ A descrição do horário padrão como uma cadeia de caracteres do formulário @path,-stringID[;comentário].
Std REG_SZ A descrição do horário padrão.
TZI REG_BINARY As informações de fuso horário a seguir.
typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;

 

Para obter mais informações sobre a chave DST dinâmica , consulte DYNAMIC_TIME_ZONE_INFORMATION.

StandardName e DaylightName são localizados de acordo com o idioma de interface do usuário padrão do usuário atual.

Exemplos

Para obter um exemplo, consulte SetTimeZoneInformation.

Requisitos

   
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]
Cabeçalho timezoneapi.h (inclua Windows.h)

Confira também

DYNAMIC_TIME_ZONE_INFORMATION

Gettimezoneinformation

SYSTEMTIME

SetTimeZoneInformation