TimeZoneInfo TimeZoneInfo TimeZoneInfo TimeZoneInfo Class

Definição

Representa qualquer fuso horário do mundo.Represents any time zone in the world.

public ref class TimeZoneInfo sealed : 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>
    interface ISerializable
    interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
Herança
TimeZoneInfoTimeZoneInfoTimeZoneInfoTimeZoneInfo
Atributos
Implementações

Comentários

Um fuso horário é uma região geográfica na qual o mesmo horário é usado.A time zone is a geographical region in which the same time is used.

A TimeZoneInfo classe oferece aprimoramentos significativos sobre a TimeZone classe, que fornece apenas funcionalidade limitada.The TimeZoneInfo class offers significant enhancements over the TimeZone class, which provides only limited functionality.

A TimeZone classe reconhece apenas o fuso horário local e pode converter horários entre UTC (tempo Universal Coordenado) e hora local.The TimeZone class recognizes only the local time zone, and can convert times between Coordinated Universal Time (UTC) and local time. Um TimeZoneInfo objeto pode representar qualquer fuso horário e os métodos TimeZoneInfo da classe podem ser usados para converter a hora em um fuso horário para a hora correspondente em qualquer outro fuso horário.A TimeZoneInfo object can represent any time zone, and methods of the TimeZoneInfo class can be used to convert the time in one time zone to the corresponding time in any other time zone. Os membros da TimeZoneInfo classe dão suporte às seguintes operações:The members of the TimeZoneInfo class support the following operations:

  • Recuperando um fuso horário que já está definido pelo sistema operacional.Retrieving a time zone that is already defined by the operating system.

  • Enumerando os fusos horários que estão disponíveis em um sistema.Enumerating the time zones that are available on a system.

  • Conversão de horas entre diferentes fusos horários.Converting times between different time zones.

  • Criando um novo fuso horário que ainda não está definido pelo sistema operacional.Creating a new time zone that is not already defined by the operating system.

  • Serialização de um fuso horário para recuperação posterior.Serializing a time zone for later retrieval.

Observação

Uma instância da TimeZoneInfo classe é imutável.An instance of the TimeZoneInfo class is immutable. Depois que um objeto tiver sido instanciado, seus valores não poderão ser modificados.Once an object has been instantiated, its values cannot be modified.

Você não pode criar TimeZoneInfo uma instância de new um objeto usando a palavra-chave.You cannot instantiate a TimeZoneInfo object using the new keyword. Em vez disso, você deve chamar um dos membros estáticos TimeZoneInfo da classe mostrada na tabela a seguir.Instead, you must call one of the static members of the TimeZoneInfo class shown in the following table.

Nome do membro estáticoStatic member name DescriçãoDescription
Método CreateCustomTimeZoneCreateCustomTimeZone method Cria um fuso horário personalizado com base nos dados fornecidos pelo aplicativo.Creates a custom time zone from application-supplied data.
Método FindSystemTimeZoneByIdFindSystemTimeZoneById method Cria uma instância de um fuso horário com base em seu identificador.Instantiates a time zone based on its identifier.
Método FromSerializedStringFromSerializedString method Desserializa um valor de cadeia de caracteres para recriar um objeto serializado TimeZoneInfo anteriormente.Deserializes a string value to re-create a previously serialized TimeZoneInfo object.
Método GetSystemTimeZonesGetSystemTimeZones method Retorna um ReadOnlyCollection<T> enumerável TimeZoneInfo de objetos que representa todos os fusos horários disponíveis no sistema local.Returns an enumerable ReadOnlyCollection<T> of TimeZoneInfo objects that represents all time zones that are available on the local system.
Propriedade LocalLocal property Cria uma instância TimeZoneInfo de um objeto que representa o fuso horário local.Instantiates a TimeZoneInfo object that represents the local time zone.
Propriedade UtcUtc property Cria uma instância TimeZoneInfo de um objeto que representa a zona UTC.Instantiates a TimeZoneInfo object that represents the UTC zone.

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 pelas classes de fuso horário na biblioteca do ICU no Linux ou no MacOS.You can use the CreateCustomTimeZone method to create a time zone that is not defined in the local system registry on Windows systems or by the time zone classes in the ICU Library on Linux or macOS. Em seguida, você pode ToSerializedString usar a propriedade para salvar as informações do objeto de fuso horário como uma cadeia de caracteres, que pode ser armazenada em algum formato que seja acessível ao aplicativo.You can then use the ToSerializedString property to save the time zone object's information as a string, which can be stored in some form that is accessible to the application. Você pode usar o FromSerializedString método para converter uma cadeia de caracteres serializada TimeZoneInfo de volta em um objeto.You can use the FromSerializedString method to convert a serialized string back to a TimeZoneInfo object.

Propriedades

BaseUtcOffset BaseUtcOffset BaseUtcOffset BaseUtcOffset

Obtém a diferença de tempo entre o tempo padrão e o UTC (Tempo Universal Coordenado) do fuso horário atual.Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).

DaylightName DaylightName DaylightName DaylightName

Obtém o nome de exibição para o horário de verão do fuso horário atual.Gets the display name for the current time zone's daylight saving time.

DisplayName DisplayName DisplayName DisplayName

Obtém o nome de exibição geral que representa o fuso horário.Gets the general display name that represents the time zone.

Id Id Id Id

Obtém o identificador de fuso horário.Gets the time zone identifier.

Local Local Local Local

Obtém um objeto TimeZoneInfo que representa o fuso horário local.Gets a TimeZoneInfo object that represents the local time zone.

StandardName StandardName StandardName StandardName

Obtém o nome de exibição do horário padrão do fuso horário.Gets the display name for the time zone's standard time.

SupportsDaylightSavingTime SupportsDaylightSavingTime SupportsDaylightSavingTime SupportsDaylightSavingTime

Obtém um valor que indica se o fuso horário tem regras de horário de verão.Gets a value indicating whether the time zone has any daylight saving time rules.

Utc Utc Utc Utc

Obtém um objeto TimeZoneInfo que representa a zona UTC (Tempo Universal Coordenado).Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

Métodos

ClearCachedData() ClearCachedData() ClearCachedData() ClearCachedData()

Limpa dados de fuso horário armazenados em cache.Clears cached time zone data.

ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo)

Converte uma hora na hora em um determinado fuso horário.Converts a time to the time in a particular time zone.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

Converte um horário de um fuso horário para outro.Converts a time from one time zone to another.

ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo)

Converte uma hora na hora em um determinado fuso horário.Converts a time to the time in a particular time zone.

ConvertTimeBySystemTimeZoneId(DateTime, String) ConvertTimeBySystemTimeZoneId(DateTime, String) ConvertTimeBySystemTimeZoneId(DateTime, String) ConvertTimeBySystemTimeZoneId(DateTime, String)

Converte um horário para o horário em outro fuso horário com base no identificador do fuso horário.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeBySystemTimeZoneId(DateTime, String, String) ConvertTimeBySystemTimeZoneId(DateTime, String, String) ConvertTimeBySystemTimeZoneId(DateTime, String, String) ConvertTimeBySystemTimeZoneId(DateTime, String, String)

Converte uma hora de um fuso horário para outro com base em identificadores de fuso horário.Converts a time from one time zone to another based on time zone identifiers.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Converte um horário para o horário em outro fuso horário com base no identificador do fuso horário.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeFromUtc(DateTime, TimeZoneInfo) ConvertTimeFromUtc(DateTime, TimeZoneInfo) ConvertTimeFromUtc(DateTime, TimeZoneInfo) ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Converte um UTC (Tempo Universal Coordenado) no horário em um fuso horário especificado.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

ConvertTimeToUtc(DateTime) ConvertTimeToUtc(DateTime) ConvertTimeToUtc(DateTime) ConvertTimeToUtc(DateTime)

Converte a data e hora especificadas em UTC (Tempo Universal Coordenado).Converts the specified date and time to Coordinated Universal Time (UTC).

ConvertTimeToUtc(DateTime, TimeZoneInfo) ConvertTimeToUtc(DateTime, TimeZoneInfo) ConvertTimeToUtc(DateTime, TimeZoneInfo) ConvertTimeToUtc(DateTime, TimeZoneInfo)

Converte o horário em um fuso horário especificado no UTC (Tempo Universal Coordenado).Converts the time in a specified time zone to Coordinated Universal Time (UTC).

CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) 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.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, and a standard time display name.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) 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.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, and daylight saving time rules.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) 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.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, daylight saving time rules, and a value that indicates whether the returned object reflects daylight saving time information.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto TimeZoneInfo atual e outro objeto são iguais.Determines whether the current TimeZoneInfo object and another object are equal.

Equals(TimeZoneInfo) Equals(TimeZoneInfo) Equals(TimeZoneInfo) Equals(TimeZoneInfo)

Determina se o objeto TimeZoneInfo atual e outro objeto TimeZoneInfo são iguais.Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.

FindSystemTimeZoneById(String) FindSystemTimeZoneById(String) FindSystemTimeZoneById(String) FindSystemTimeZoneById(String)

Cria uma instância de um novo objeto TimeZoneInfo, com base em seu identificador.Instantiates a new TimeZoneInfo object based on its identifier.

FromSerializedString(String) FromSerializedString(String) FromSerializedString(String) FromSerializedString(String)

Desserializa uma cadeia de caracteres para recriar um objeto original TimeZoneInfo desserializado.Deserializes a string to re-create an original serialized TimeZoneInfo object.

GetAdjustmentRules() GetAdjustmentRules() GetAdjustmentRules() GetAdjustmentRules()

Recupera uma matriz de objetos TimeZoneInfo.AdjustmentRule que se aplicam ao objeto TimeZoneInfo atual.Retrieves an array of TimeZoneInfo.AdjustmentRule objects that apply to the current TimeZoneInfo object.

GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime) 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.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetAmbiguousTimeOffsets(DateTimeOffset) GetAmbiguousTimeOffsets(DateTimeOffset) GetAmbiguousTimeOffsets(DateTimeOffset) 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.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funciona como uma função de hash para algoritmos de hash atuais e estruturas de dados como tabelas de hash.Serves as a hash function for hashing algorithms and data structures such as hash tables.

GetSystemTimeZones() GetSystemTimeZones() GetSystemTimeZones() GetSystemTimeZones()

Retorna uma coleção classificada de todos os fuso horários sobre os quais há informações disponíveis no sistema local.Returns a sorted collection of all the time zones about which information is available on the local system.

GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
GetUtcOffset(DateTime) GetUtcOffset(DateTime) GetUtcOffset(DateTime) 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.Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.

GetUtcOffset(DateTimeOffset) GetUtcOffset(DateTimeOffset) GetUtcOffset(DateTimeOffset) 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.Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.

HasSameRules(TimeZoneInfo) HasSameRules(TimeZoneInfo) HasSameRules(TimeZoneInfo) HasSameRules(TimeZoneInfo)

Indica se o objeto atual e outro objeto TimeZoneInfo têm as mesmas regras de ajuste.Indicates whether the current object and another TimeZoneInfo object have the same adjustment rules.

IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime) 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).Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset) 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).Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime) 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.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset) 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.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsInvalidTime(DateTime) IsInvalidTime(DateTime) IsInvalidTime(DateTime) IsInvalidTime(DateTime)

Indica se uma data e hora determinada é inválida.Indicates whether a particular date and time is invalid.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToSerializedString() ToSerializedString() ToSerializedString() ToSerializedString()

Converte o objeto TimeZoneInfo atual para uma cadeia de caracteres serializada.Converts the current TimeZoneInfo object to a serialized string.

ToString() ToString() ToString() ToString()

Retorna o nome de exibição do objeto TimeZoneInfo atual.Returns the current TimeZoneInfo object's display name.

Implantações explícitas de interface

IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object)

Executado quando a desserialização de um objeto foi concluída.Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um objeto SerializationInfo com os dados necessários para serializar o objeto TimeZoneInfo atual.Populates a SerializationInfo object with the data needed to serialize the current TimeZoneInfo object.

Aplica-se a