Compartilhar via


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

Comentários

Um fuso horário é uma região geográfica na qual o mesmo horário é usado.

A TimeZoneInfo classe oferece aprimoramentos significativos em relação à TimeZone classe , que fornece apenas funcionalidade limitada.

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

  • Recuperando um fuso horário que já está definido pelo sistema operacional.

  • Enumerando os fusos horários disponíveis em um sistema.

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

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

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

Observação

Uma instância da TimeZoneInfo classe é imutável. Depois que um objeto tiver sido instanciado, seus valores não poderão ser modificados.

Não é possível instanciar um TimeZoneInfo objeto usando o new palavra-chave. Em vez disso, você deve chamar um dos membros estáticos da TimeZoneInfo classe mostrada na tabela a seguir.

Nome do membro estático Descrição
Método CreateCustomTimeZone Cria um fuso horário personalizado com base em dados fornecidos pelo aplicativo.
Método FindSystemTimeZoneById Cria uma instância de um fuso horário com base em seu identificador.
Método FromSerializedString Desserializa um valor de cadeia de caracteres para recriar um objeto serializado TimeZoneInfo anteriormente.
Método GetSystemTimeZones Retorna um enumerável ReadOnlyCollection<T> de TimeZoneInfo objetos que representa todos os fusos horários disponíveis no sistema local.
Propriedade Local Cria uma instância de um TimeZoneInfo objeto que representa o fuso horário local.
Propriedade Utc Cria uma instância de um TimeZoneInfo objeto que representa a zona UTC.

Você pode usar o CreateCustomTimeZone método para criar um fuso horário que não esteja definido no registro do sistema local em sistemas Windows ou pelos Dados de Fuso Horário da Biblioteca de UTI no Linux ou macOS. Em seguida, você pode usar a ToSerializedString propriedade para salvar as informações do objeto de fuso horário como uma cadeia de caracteres, que pode ser armazenada de alguma forma acessível ao aplicativo. Você pode usar o FromSerializedString método para converter uma cadeia de caracteres serializada de volta em um TimeZoneInfo objeto .

Propriedades

BaseUtcOffset

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

DaylightName

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

DisplayName

Obtém o nome de exibição geral que representa o fuso horário.

HasIanaId

Retornará true se esse objeto TimeZoneInfo tiver uma ID IANA.

Id

Obtém o identificador de fuso horário.

Local

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

StandardName

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

SupportsDaylightSavingTime

Obtém um valor que indica se o fuso horário tem regras de horário de verão.

Utc

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

Métodos

ClearCachedData()

Limpa dados de fuso horário armazenados em cache.

ConvertTime(DateTime, TimeZoneInfo)

Converte uma hora na hora em um determinado fuso horário.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

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

ConvertTime(DateTimeOffset, TimeZoneInfo)

Converte uma hora na hora em um determinado fuso horário.

ConvertTimeBySystemTimeZoneId(DateTime, String)

Converte um horário para o horário em outro fuso horário com base no identificador do fuso horário.

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

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

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Converte um horário para o horário em outro fuso horário com base no identificador do fuso horário.

ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Converte um UTC (Tempo Universal Coordenado) no horário em um fuso horário especificado.

ConvertTimeToUtc(DateTime)

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

ConvertTimeToUtc(DateTime, TimeZoneInfo)

Converte o horário em um fuso horário especificado no UTC (Tempo Universal Coordenado).

CreateCustomTimeZone(String, TimeSpan, String, String)

Cria um fuso horário personalizado com um identificador especificado, um desvio de UTC (Tempo Universal Coordenado), um nome de exibição e um nome de exibição do horário padrão.

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

Cria um fuso horário personalizado com um identificador especificado, um deslocamento do UTC (Tempo Universal Coordenado), um nome de exibição, um nome de hora padrão e um nome e regras do horário de verão.

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

Cria um fuso horário personalizado com um identificador especificado, um deslocamento do UTC (Tempo Universal Coordenado), um nome de exibição, um nome de hora 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 retornado reflete as informações sobre horário de verão.

Equals(Object)

Determina se o objeto TimeZoneInfo atual 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 TimeZoneInfo atual e outro objeto TimeZoneInfo são iguais.

FindSystemTimeZoneById(String)

Retorna um TimeZoneInfo objeto com base em seu identificador.

FromSerializedString(String)

Desserializa uma cadeia de caracteres para recriar um objeto original TimeZoneInfo desserializado.

GetAdjustmentRules()

Recupera uma matriz de objetos TimeZoneInfo.AdjustmentRule que se aplicam ao objeto TimeZoneInfo atual.

GetAmbiguousTimeOffsets(DateTime)

Retorna informações sobre as datas e as horas possíveis para as quais uma data e hora ambíguas podem ser mapeadas.

GetAmbiguousTimeOffsets(DateTimeOffset)

Retorna informações sobre as datas e as horas possíveis para as quais uma data e hora ambíguas podem ser mapeadas.

GetHashCode()

Funciona como uma função de hash para algoritmos de hash atuais e estruturas de dados como tabelas de hash.

GetSystemTimeZones()

Retorna uma coleção classificada de todos os fuso horários sobre os quais há informações disponíveis no sistema local.

GetSystemTimeZones(Boolean)

Retorna um ReadOnlyCollection<T> que contém todos os TimeZone válidos do computador local. Esse método não lança TimeZoneNotFoundException ou InvalidTimeZoneException.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUtcOffset(DateTime)

Calcula o deslocamento ou a diferença entre o momento neste fuso horário e o Tempo Universal Coordenado (UTC) para uma determinada data e hora.

GetUtcOffset(DateTimeOffset)

Calcula o deslocamento ou a diferença entre o momento neste fuso horário e o Tempo Universal Coordenado (UTC) para uma determinada data e hora.

HasSameRules(TimeZoneInfo)

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

IsAmbiguousTime(DateTime)

Determina se uma determinada data e hora em um fuso horário específico é ambígua e pode ser mapeada para duas ou mais horas do Tempo Universal Coordenado (UTC).

IsAmbiguousTime(DateTimeOffset)

Determina se uma determinada data e hora em um fuso horário específico é ambígua e pode ser mapeada para duas ou mais horas do Tempo Universal Coordenado (UTC).

IsDaylightSavingTime(DateTime)

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

IsDaylightSavingTime(DateTimeOffset)

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

IsInvalidTime(DateTime)

Indica se uma data e hora determinada é inválida.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToSerializedString()

Converte o objeto TimeZoneInfo atual para uma cadeia de caracteres serializada.

ToString()

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

TryConvertIanaIdToWindowsId(String, String)

Tenta converter uma ID de fuso horário IANA em uma ID do Windows.

TryConvertWindowsIdToIanaId(String, String)

Tenta converter uma ID de fuso horário do Windows em uma ID IANA.

TryConvertWindowsIdToIanaId(String, String, String)

Tenta converter uma ID de fuso horário do Windows em uma ID IANA.

TryFindSystemTimeZoneById(String, TimeZoneInfo)

Recupera um TimeZoneInfo objeto por nome de fuso horário.

Implantações explícitas de interface

IDeserializationCallback.OnDeserialization(Object)

Executado quando a desserialização de um objeto foi concluída.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Aplica-se a