TimeZoneInfo TimeZoneInfo TimeZoneInfo TimeZoneInfo Class

Definición

Representa cualquier zona horaria del 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
Herencia
TimeZoneInfoTimeZoneInfoTimeZoneInfoTimeZoneInfo
Atributos
Implementaciones

Comentarios

Una zona horaria es una región geográfica en la que se usa la misma hora.A time zone is a geographical region in which the same time is used.

El TimeZoneInfo clase ofrece importantes mejoras sobre la TimeZone (clase), que proporciona funcionalidad limitada.The TimeZoneInfo class offers significant enhancements over the TimeZone class, which provides only limited functionality.

La TimeZone clase reconoce solo la zona horaria local y puede convertir horas entre la hora Universal coordinada (UTC) y la hora local.The TimeZone class recognizes only the local time zone, and can convert times between Coordinated Universal Time (UTC) and local time. Un TimeZoneInfo objeto puede representar cualquier zona horaria y los métodos de la TimeZoneInfo clase puede usarse para convertir la hora de una zona horaria a la hora correspondiente en cualquier otra zona horaria.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. Los miembros de la TimeZoneInfo clase admiten las siguientes operaciones:The members of the TimeZoneInfo class support the following operations:

  • Recuperar una zona horaria que ya está definida por el sistema operativo.Retrieving a time zone that is already defined by the operating system.

  • Enumerar las zonas horarias que están disponibles en un sistema.Enumerating the time zones that are available on a system.

  • Convertir horas entre zonas horarias diferentes.Converting times between different time zones.

  • Crear una nueva zona horaria que ya no está definida por el sistema operativo.Creating a new time zone that is not already defined by the operating system.

  • Serializar una zona horaria para su recuperación posterior.Serializing a time zone for later retrieval.

Nota

Una instancia de la TimeZoneInfo clase es inmutable.An instance of the TimeZoneInfo class is immutable. Una vez que se ha creado una instancia de un objeto, no se puede modificar sus valores.Once an object has been instantiated, its values cannot be modified.

No se puede crear una instancia un TimeZoneInfo objeto utilizando el new palabra clave.You cannot instantiate a TimeZoneInfo object using the new keyword. En su lugar, debe llamar a uno de los miembros estáticos de la TimeZoneInfo clase que se muestra en la tabla siguiente.Instead, you must call one of the static members of the TimeZoneInfo class shown in the following table.

Nombre de miembro estáticoStatic member name DescripciónDescription
Método CreateCustomTimeZoneCreateCustomTimeZone method Crea una zona horaria personalizada a partir de datos proporcionada por la aplicación.Creates a custom time zone from application-supplied data.
Método FindSystemTimeZoneByIdFindSystemTimeZoneById method Crea una instancia de una zona horaria basándose en su identificador.Instantiates a time zone based on its identifier.
Método FromSerializedStringFromSerializedString method Deserializa un valor de cadena para volver a crear un serializador previamente TimeZoneInfo objeto.Deserializes a string value to re-create a previously serialized TimeZoneInfo object.
Método GetSystemTimeZonesGetSystemTimeZones method Devuelve un enumerable ReadOnlyCollection<T> de TimeZoneInfo objetos que representan todas las zonas horarias que están disponibles en el sistema local.Returns an enumerable ReadOnlyCollection<T> of TimeZoneInfo objects that represents all time zones that are available on the local system.
PropiedadLocal Local property Crea una instancia de un TimeZoneInfo objeto que representa la zona horaria local.Instantiates a TimeZoneInfo object that represents the local time zone.
PropiedadUtc Utc property Crea una instancia de un TimeZoneInfo objeto que representa la zona de hora UTC.Instantiates a TimeZoneInfo object that represents the UTC zone.

Puede usar el CreateCustomTimeZone método para crear una zona horaria que no está definida en el registro del sistema local en los sistemas de Windows o las clases de zona horaria en el ICU biblioteca en Linux o 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. A continuación, puede usar el ToSerializedString propiedad que se va a guardar la información de zona horaria del objeto como una cadena, que se puede almacenar en alguna forma que sea accesible para la aplicación.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. Puede usar el FromSerializedString realizar una copia del método para convertir una cadena serializada en una TimeZoneInfo objeto.You can use the FromSerializedString method to convert a serialized string back to a TimeZoneInfo object.

Propiedades

BaseUtcOffset BaseUtcOffset BaseUtcOffset BaseUtcOffset

Obtiene la diferencia horaria entre la hora estándar de la zona horaria actual y la hora universal coordinada (hora UTC).Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).

DaylightName DaylightName DaylightName DaylightName

Obtiene el nombre para mostrar para el horario de verano de la zona horaria actual.Gets the display name for the current time zone's daylight saving time.

DisplayName DisplayName DisplayName DisplayName

Obtiene el nombre para mostrar general que representa la zona horaria.Gets the general display name that represents the time zone.

Id Id Id Id

Obtiene el identificador de la zona horaria.Gets the time zone identifier.

Local Local Local Local

Obtiene un objeto TimeZoneInfo que representa la zona horaria local.Gets a TimeZoneInfo object that represents the local time zone.

StandardName StandardName StandardName StandardName

Obtiene el nombre para mostrar de la hora estándar de la zona horaria.Gets the display name for the time zone's standard time.

SupportsDaylightSavingTime SupportsDaylightSavingTime SupportsDaylightSavingTime SupportsDaylightSavingTime

Obtiene un valor que indica si la zona horaria tiene alguna regla de horario de verano.Gets a value indicating whether the time zone has any daylight saving time rules.

Utc Utc Utc Utc

Obtiene un objeto TimeZoneInfo que representa la zona horaria universal coordinada (hora UTC).Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

Métodos

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

Borra los datos de zona horaria almacenados en caché.Clears cached time zone data.

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

Convierte una hora en la hora de una zona horaria determinada.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)

Convierte una hora de una zona horaria en otra.Converts a time from one time zone to another.

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

Convierte una hora en la hora de una zona horaria determinada.Converts a time to the time in a particular time zone.

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

Convierte una hora en la hora de otra zona horaria basándose en el identificador de zona horaria.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)

Convierte una hora de una zona horaria en otra basándose en los identificadores de zona horaria.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)

Convierte una hora en la hora de otra zona horaria basándose en el identificador de zona horaria.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)

Convierte una hora universal coordinada (UTC) en la hora de una zona horaria especificada.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

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

Convierte la fecha y hora especificadas en hora universal coordinada (UTC).Converts the specified date and time to Coordinated Universal Time (UTC).

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

Convierte la hora de una zona horaria determinada en hora universal coordinada (UTC).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)

Crea una zona horaria personalizada con un identificador especificado, un desplazamiento de hora universal coordinada (UTC), un nombre para mostrar y un nombre para mostrar de hora estándar.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[])

Crea una zona horaria personalizada con un identificador especificado, un desplazamiento de la hora universal coordinada (UTC), un nombre para mostrar, un nombre de hora estándar, un nombre de horario de verano y las reglas del horario de verano.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)

Crea una zona horaria personalizada con un identificador especificado, un desplazamiento de hora universal coordinada (UTC), un nombre para mostrar, un nombre de hora estándar, un nombre del horario de verano, las reglas del horario de verano y un valor que indica si el objeto devuelto refleja la información del horario de verano.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 si el objeto TimeZoneInfo actual y otro objeto son iguales.Determines whether the current TimeZoneInfo object and another object are equal.

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

Determina si el objeto TimeZoneInfo actual y otro objeto TimeZoneInfo son iguales.Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.

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

Crea instancias de un nuevo objeto TimeZoneInfo según su identificador.Instantiates a new TimeZoneInfo object based on its identifier.

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

Deserializa una cadena para volver a crear un objeto TimeZoneInfo serializado original.Deserializes a string to re-create an original serialized TimeZoneInfo object.

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

Recupera una matriz de objetos TimeZoneInfo.AdjustmentRule que se aplican al objeto TimeZoneInfo actual.Retrieves an array of TimeZoneInfo.AdjustmentRule objects that apply to the current TimeZoneInfo object.

GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime)

Devuelve información sobre las posibles fechas y horas a las que se puede asignar una fecha y hora ambigua.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)

Devuelve información sobre las posibles fechas y horas a las que se puede asignar una fecha y hora ambigua.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

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

Actúa como una función hash para los algoritmos hash y estructuras de datos como las tablas hash.Serves as a hash function for hashing algorithms and data structures such as hash tables.

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

Devuelve una colección ordenada de todas las zonas horarias sobre qué información está disponible en el sistema local.Returns a sorted collection of all the time zones about which information is available on the local system.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUtcOffset(DateTime) GetUtcOffset(DateTime) GetUtcOffset(DateTime) GetUtcOffset(DateTime)

Calcula el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.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 el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.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 si el objeto actual y otro objeto TimeZoneInfo tienen las mismas reglas 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 si un valor de fecha y hora determinado en una zona horaria concreta es ambiguo y se puede asignar a dos o más horas UTC (hora universal coordinada).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 si un valor de fecha y hora determinado en una zona horaria concreta es ambiguo y se puede asignar a dos o más horas UTC (hora universal coordinada).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 si una fecha y hora especificadas están en el intervalo de horario de verano de la zona horaria del objeto TimeZoneInfo actual.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 si una fecha y hora especificadas están en el intervalo de horario de verano de la zona horaria del objeto TimeZoneInfo actual.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 si una fecha y hora determinadas no son válidas.Indicates whether a particular date and time is invalid.

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

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

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

Convierte el objeto TimeZoneInfo actual en una cadena serializada.Converts the current TimeZoneInfo object to a serialized string.

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

Devuelve el nombre para mostrar del objeto TimeZoneInfo actual.Returns the current TimeZoneInfo object's display name.

Implementaciones de interfaz explícitas

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

Se ejecuta cuando se completa la deserialización de un objeto.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)

Rellena un objeto SerializationInfo con los datos necesarios para serializar el objeto TimeZoneInfo actual.Populates a SerializationInfo object with the data needed to serialize the current TimeZoneInfo object.

Se aplica a