TimeZoneInfo Classe

Definição

Representa qualquer fuso horário do mundo.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>
public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>
[System.Serializable]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
[<System.Serializable>]
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable
Public NotInheritable Class TimeZoneInfo
Implements IEquatable(Of TimeZoneInfo)
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
Herança
TimeZoneInfo
Atributos
Implementações

Observações

Um fuso horário é uma região geográfica na qual a mesma hora é usada.

A TimeZoneInfo classe oferece melhorias significativas em relação à TimeZone classe, que oferece apenas funcionalidades limitadas.

A TimeZone classe reconhece apenas o fuso horário local e pode converter horários entre o Tempo Universal Coordenado (UTC) e o horário local. Um TimeZoneInfo objeto pode representar qualquer fuso horário, e métodos da TimeZoneInfo classe podem ser usados para converter a hora de um fuso horário para a hora correspondente em qualquer outro fuso horário. Os membros da TimeZoneInfo classe apoiam as seguintes operações:

  • Recuperar um fuso horário já definido pelo sistema operativo.

  • Enumerar os fusos horários disponíveis num sistema.

  • Converter horários entre diferentes fusos horários.

  • Criar um novo fuso horário que ainda não está definido pelo sistema operativo.

  • Serializando um fuso horário para recuperação posterior.

Note

Uma instância da TimeZoneInfo classe é imutável. Depois de um objeto ter sido instanciado, os seus valores não podem ser modificados.

Não pode instanciar um TimeZoneInfo objeto usando a new palavra-chave. Em vez disso, deve chamar um dos membros estáticos da TimeZoneInfo classe mostrada na tabela seguinte.

Nome estático do membro Description
CreateCustomTimeZone método Cria um fuso horário personalizado a partir dos dados fornecidos pela aplicação.
FindSystemTimeZoneById método Instancia um fuso horário com base no seu identificador.
FromSerializedString método Desserializa um valor de cadeia para recriar um objeto previamente serializado TimeZoneInfo .
GetSystemTimeZones método Devolve um enumerável ReadOnlyCollection<T> de TimeZoneInfo objetos que representa todos os fusos horários disponíveis no sistema local.
Local propriedade Instancia um TimeZoneInfo objeto que representa o fuso horário local.
Utc propriedade Instancia um TimeZoneInfo objeto que representa a zona UTC.

Pode usar o método para criar um fuso horário que não esteja definido no registo local do sistema Windows sistemas ou pelo Time Zone Data da Biblioteca ICU no Linux ou macOS. Pode então usar a ToSerializedString() propriedade para guardar a informação do objeto do fuso horário como uma cadeia, que pode ser armazenada numa forma acessível à aplicação. Podes usar o FromSerializedString método para converter uma cadeia serializada de volta num TimeZoneInfo objeto.

Propriedades

Name Description
BaseUtcOffset

Obtém a diferença horária entre o horário padrão do fuso horário atual e o Horário Universal Coordenado (UTC).

DaylightName

Obtém o nome de visualização para o horário de verão do fuso horário atual.

DisplayName

Recebe o nome geral de visualização que representa o fuso horário.

Id

Obtém o identificador do fuso horário.

Local

Obtém um TimeZoneInfo objeto que representa o fuso horário local.

StandardName

Obtém o nome de exibição para a hora padrão do fuso horário.

SupportsDaylightSavingTime

Recebe um valor que indica se o fuso horário tem alguma regra de horário de verão.

Utc

Obtém um TimeZoneInfo objeto que representa a zona de Tempo Universal Coordenado (UTC).

Métodos

Name Description
ClearCachedData()

Apaga dados de fuso horário em cache.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

Converte uma hora de um fuso horário para outro.

ConvertTime(DateTime, TimeZoneInfo)

Converte uma hora para a hora de um determinado fuso horário.

ConvertTime(DateTimeOffset, TimeZoneInfo)

Converte uma hora para a hora de um determinado fuso horário.

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

Converte uma hora de um fuso horário para outro com base nos identificadores de fuso horário.

ConvertTimeBySystemTimeZoneId(DateTime, String)

Converte uma hora para a hora noutro fuso horário com base no identificador do fuso horário.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Converte uma hora para a hora noutro fuso horário com base no identificador do fuso horário.

ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Converte uma Hora Universal Coordenada (UTC) para a hora num fuso horário especificado.

ConvertTimeToUtc(DateTime, TimeZoneInfo)

Converte a hora num fuso horário especificado para Hora Universal Coordenada (UTC).

ConvertTimeToUtc(DateTime)

Converte a data e hora especificadas para Tempo Universal Coordenado (UTC).

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)

Cria um fuso horário personalizado com um identificador especificado, um deslocamento em relação ao Horário Universal Coordenado (UTC), um nome de exibição, um nome de horário padrão, um nome de horário de verão, regras de horário de verão e um valor que indica se o objeto devolvido reflete informação sobre o horário de verão.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])

Cria um fuso horário personalizado com um identificador especificado, um deslocamento em relação ao Horário Universal Coordenado (UTC), um nome de visualização, um nome de horário padrão, um nome de horário de verão e regras de horário de verão.

CreateCustomTimeZone(String, TimeSpan, String, String)

Cria um fuso horário personalizado com um identificador especificado, um deslocamento em relação à Hora Universal Coordenada (UTC), um nome de exibição e um nome de exibição de hora padrão.

Equals(Object)

Determina se o objeto atual TimeZoneInfo e outro objeto são iguais.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Equals(TimeZoneInfo)

Determina se o objeto atual TimeZoneInfo e outro TimeZoneInfo objeto são iguais.

FindSystemTimeZoneById(String)

Devolve um TimeZoneInfo objeto com base no seu identificador.

FromSerializedString(String)

Desserializa uma cadeia para recriar um objeto serializado TimeZoneInfo original.

GetAdjustmentRules()

Recupera um array de TimeZoneInfo.AdjustmentRule objetos que se aplicam ao objeto atual TimeZoneInfo .

GetAmbiguousTimeOffsets(DateTime)

Devolve informações sobre as possíveis datas e horas para as quais uma data e hora ambíguas pode ser mapeada.

GetAmbiguousTimeOffsets(DateTimeOffset)

Devolve informações sobre as possíveis datas e horas para as quais uma data e hora ambíguas pode ser mapeada.

GetHashCode()

Serve como função de hash para algoritmos de hash e estruturas de dados como tabelas de hash.

GetSystemTimeZones()

Devolve uma coleção ordenada de todos os fusos horários sobre os quais a informação disponível no sistema local.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUtcOffset(DateTime)

Calcula o deslocamento ou diferença entre a hora neste fuso horário e a Hora Universal Coordenada (UTC) para uma data e hora específicas.

GetUtcOffset(DateTimeOffset)

Calcula o deslocamento ou diferença entre a hora neste fuso horário e a Hora Universal Coordenada (UTC) para uma data e hora específicas.

HasSameRules(TimeZoneInfo)

Indica se o objeto atual e outro TimeZoneInfo objeto têm as mesmas regras de ajuste.

IsAmbiguousTime(DateTime)

Determina se uma data e hora específicas num determinado fuso horário são ambíguas e pode ser mapeada para duas ou mais horas de Tempo Universal Coordenado (UTC).

IsAmbiguousTime(DateTimeOffset)

Determina se uma data e hora específicas num determinado fuso horário são ambíguas e pode ser mapeada para duas ou mais horas de Tempo Universal Coordenado (UTC).

IsDaylightSavingTime(DateTime)

Indica se uma data e hora especificadas se enquadram no intervalo do horário de verão do fuso horário do objeto atual TimeZoneInfo .

IsDaylightSavingTime(DateTimeOffset)

Indica se uma data e hora especificadas se enquadram no intervalo do horário de verão do fuso horário do objeto atual TimeZoneInfo .

IsInvalidTime(DateTime)

Indica se uma data e hora específicas são inválidas.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToSerializedString()

Converte o objeto atual TimeZoneInfo numa cadeia serializada.

ToString()

Devolve o nome de exibição do objeto atual TimeZoneInfo .

Implementações de Interface Explícita

Name Description
IDeserializationCallback.OnDeserialization(Object)

Executa-se quando a desserialização de um objeto foi concluída.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Preenche um SerializationInfo objeto com os dados necessários para serializar o objeto atual TimeZoneInfo .

Aplica-se a