TimeZoneInfo Classe

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

TimeZoneInfo.cs

Representa qualquer fuso horário no mundo.

public ref class TimeZoneInfo sealed : 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>
    interface IDeserializationCallback
    interface ISerializable

Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable

Herança

Object

TimeZoneInfo

Implementações

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

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 à classe, que TimeZone fornece apenas funcionalidade limitada.

A TimeZone classe reconhece apenas o fuso horário local e pode converter horários entre UTC (Tempo Universal Coordenado) e hora local. Um TimeZoneInfo objeto pode representar qualquer fuso horário e os TimeZoneInfo métodos da classe podem ser usados para converter a hora 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 criar uma instância de um TimeZoneInfo objeto usando a new palavra-chave. Em vez disso, você deve chamar um dos membros estáticos da TimeZoneInfo classe mostrado na tabela a seguir.

Nome do membro estático	Descrição
método CreateCustomTimeZone	Cria um fuso horário personalizado com base nos 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 uma 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 é 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

Nome	Description
BaseUtcOffset	Obtém a diferença de tempo entre o horário padrão do fuso horário atual e o UTC (Tempo Universal Coordenado).
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	Retorna true se esse objeto TimeZoneInfo tiver uma ID IANA.
Id	Obtém o identificador de 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 o 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 TimeZoneInfo objeto que representa a zona UTC (Tempo Universal Coordenado).

Métodos

Nome	Description
ClearCachedData()	Limpa dados de fuso horário armazenados em cache.
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	Converte um horário de um fuso horário para outro.
ConvertTime(DateTime, TimeZoneInfo)	Converte uma hora para a hora em um fuso horário específico.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Converte uma hora para a hora em um fuso horário específico.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Converte um horário de um fuso horário para outro com base em identificadores de 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(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) na hora em um fuso horário especificado.
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Converte a hora em um fuso horário especificado em UTC (Tempo Universal Coordenado).
ConvertTimeToUtc(DateTime)	Converte a data e a hora especificadas em UTC (Tempo Universal Coordenado).
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)	Cria um fuso horário personalizado com um identificador especificado, um deslocamento de 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 de 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 do UTC (Tempo Universal Coordenado), um nome de exibição, um nome de hora 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 de UTC (Tempo Universal Coordenado), 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(TimeZoneInfo)	Determina se o objeto atual TimeZoneInfo e outro TimeZoneInfo objeto 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 serializado TimeZoneInfo original.
GetAdjustmentRules()	Recupera uma matriz de TimeZoneInfo.AdjustmentRule objetos que se aplicam ao objeto atual TimeZoneInfo .
GetAmbiguousTimeOffsets(DateTime)	Retorna informações sobre as possíveis datas e horas para as quais uma data e hora ambíguas podem ser mapeadas.
GetAmbiguousTimeOffsets(DateTimeOffset)	Retorna informações sobre as possíveis datas e horas para as quais uma data e hora ambíguas podem ser mapeadas.
GetHashCode()	Serve como uma função de hash para algoritmos de hash e estruturas de dados, como tabelas de hash.
GetSystemTimeZones()	Retorna uma coleção classificada de todos os fusos horários sobre quais informações estão disponíveis no sistema local.
GetSystemTimeZones(Boolean)	Retorna um ReadOnlyCollection<T> que contém todos os TimeZones 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 a hora nesse fuso horário e o UTC (Tempo Universal Coordenado) para uma data e hora específicas.
GetUtcOffset(DateTimeOffset)	Calcula o deslocamento ou a diferença entre a hora nesse fuso horário e o UTC (Tempo Universal Coordenado) 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 em um fuso horário específico são ambíguas e podem ser mapeadas para dois ou mais horários UTC (Tempo Universal Coordenado).
IsAmbiguousTime(DateTimeOffset)	Determina se uma data e hora específicas em um fuso horário específico são ambíguas e podem ser mapeadas para dois ou mais horários UTC (Tempo Universal Coordenado).
IsDaylightSavingTime(DateTime)	Indica se uma data e hora especificadas caem no intervalo de horário de verão para o fuso horário do objeto atual TimeZoneInfo .
IsDaylightSavingTime(DateTimeOffset)	Indica se uma data e hora especificadas caem no intervalo de horário de verão para o 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 Objectatual. (Herdado de Object)
ToSerializedString()	Converte o objeto atual TimeZoneInfo em uma cadeia de caracteres serializada.
ToString()	Retorna o nome de exibição do objeto atual TimeZoneInfo .
TryConvertIanaIdToWindowsId(String, String)	Tenta converter uma ID de fuso horário IANA em uma ID do Windows.
TryConvertWindowsIdToIanaId(String, String, String)	Tenta converter uma ID de fuso horário do Windows em uma ID IANA.
TryConvertWindowsIdToIanaId(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

Nome	Description
IDeserializationCallback.OnDeserialization(Object)	É executado quando a desserialização de um objeto foi concluída.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Popula um SerializationInfo objeto com os dados necessários para serializar o objeto atual TimeZoneInfo .