Como: Obter um objeto TimeZoneInfo

A forma mais comum de obter um TimeZoneInfo objeto é obter informações sobre ele do registo. Para obter o objeto, chame o static método (Shared no Visual Basic TimeZoneInfo.FindSystemTimeZoneById ), que procura no registo. Trate de quaisquer exceções lançadas pelo método, especialmente as TimeZoneNotFoundException que são lançadas se o fuso horário não estiver definido no registo.

Exemplo

O código seguinte recupera um TimeZoneInfo objeto que representa o fuso horário padrão do Leste e mostra o horário padrão do Leste correspondente à hora local.

DateTime timeNow = DateTime.Now;
try
{
    TimeZoneInfo easternZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
    DateTime easternTimeNow = TimeZoneInfo.ConvertTime(
        timeNow,
        TimeZoneInfo.Local,
        easternZone
        );
    Console.WriteLine("{0} {1} corresponds to {2} {3}.",
                      timeNow,
                      TimeZoneInfo.Local.IsDaylightSavingTime(timeNow) ?
                                TimeZoneInfo.Local.DaylightName :
                                TimeZoneInfo.Local.StandardName,
                      easternTimeNow,
                      easternZone.IsDaylightSavingTime(easternTimeNow) ?
                                  easternZone.DaylightName :
                                  easternZone.StandardName);
}
// Handle exception
//
// As an alternative to simply displaying an error message, an alternate Eastern
// Standard Time TimeZoneInfo object could be instantiated here either by restoring
// it from a serialized string or by providing the necessary data to the
// CreateCustomTimeZone method.
catch (TimeZoneNotFoundException)
{
    Console.WriteLine("The Eastern Standard Time Zone cannot be found on the local system.");
}
catch (InvalidTimeZoneException)
{
    Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.");
}
catch (SecurityException)
{
    Console.WriteLine("The application lacks permission to read time zone information from the registry.");
}
catch (OutOfMemoryException)
{
    Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.");
}
// If we weren't passing FindSystemTimeZoneById a literal string, we also
// would handle an ArgumentNullException.

Dim timeNow As Date = Date.Now
Try
    Dim easternZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
    Dim easternTimeNow As Date = TimeZoneInfo.ConvertTime(timeNow, TimeZoneInfo.Local, easternZone)
    Console.WriteLine("{0} {1} corresponds to {2} {3}.", _
                      timeNow, _
                      IIf(TimeZoneInfo.Local.IsDaylightSavingTime(timeNow), _
                          TimeZoneInfo.Local.DaylightName, TimeZoneInfo.Local.StandardName), _
                      easternTimeNow, _
                      IIf(easternZone.IsDaylightSavingTime(easternTimeNow), _
                          easternZone.DaylightName, easternZone.StandardName))
    ' Handle exception
    '
    ' As an alternative to simply displaying an error message, an alternate Eastern
    ' Standard Time TimeZoneInfo object could be instantiated here either by restoring
    ' it from a serialized string or by providing the necessary data to the
    ' CreateCustomTimeZone method.
Catch e As TimeZoneNotFoundException
    Console.WriteLine("The Eastern Standard Time Zone cannot be found on the local system.")
Catch e As InvalidTimeZoneException
    Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.")
Catch e As SecurityException
    Console.WriteLine("The application lacks permission to read time zone information from the registry.")
Catch e As OutOfMemoryException
    Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.")
    ' If we weren't passing FindSystemTimeZoneById a literal string, we also 
    ' would handle an ArgumentNullException.
End Try

O TimeZoneInfo.FindSystemTimeZoneById único parâmetro do método é o identificador do fuso horário que pretende recuperar, que corresponde à propriedade do TimeZoneInfo.Id objeto. O identificador do fuso horário é um campo de chave que identifica de forma única o fuso horário. Embora a maioria das chaves seja relativamente curta, o identificador do fuso horário é relativamente longo. Na maioria dos casos, o seu valor corresponde à StandardName propriedade de um TimeZoneInfo objeto, que é usada para fornecer o nome da hora padrão do fuso horário. No entanto, existem exceções. A melhor forma de garantir que fornece um identificador válido é enumerar os fusos horários disponíveis no seu sistema e anotar os identificadores dos fusos horários presentes neles. Para ilustrar, veja Como: Enumerar fusos horários presentes num computador. O artigo Encontrar os fusos horários definidos num sistema local também contém uma lista de identificadores de fusos horários selecionados.

Se o fuso horário for encontrado, o método devolve o seu TimeZoneInfo objeto. Se o fuso horário não for encontrado, o método lança um TimeZoneNotFoundException. Se o fuso horário for encontrado mas os seus dados estiverem corrompidos ou incompletos, o método lança um InvalidTimeZoneException.

Se a sua candidatura depender de um fuso horário que deve estar presente, deve primeiro ligar para o FindSystemTimeZoneById método para obter a informação do fuso horário do registo. Se a chamada ao método falhar, o seu tratador de exceções deve então criar uma nova instância do fuso horário ou recriá-la desserializando um objeto serializado TimeZoneInfo . Veja como: Restaurar fusos horários a partir de um recurso incorporado , por exemplo.

Consulte também

• Datas, horas e fusos horários
• Localizando os fusos horários definidos em um sistema local
• Como acessar os objetos de fuso horário local e UTC predefinidos