TimeZoneInfo Clase

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

TimeZoneInfo.cs

Representa cualquier zona horaria del 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

Herencia

Object

TimeZoneInfo

Implementaciones

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

Comentarios

Una zona horaria es una región geográfica en la que se usa la misma hora.

La TimeZoneInfo clase ofrece mejoras significativas sobre la TimeZone clase , que solo proporciona funcionalidad limitada.

La TimeZone clase reconoce solo la zona horaria local y puede convertir las horas entre la hora universal coordinada (UTC) y la hora local. Un TimeZoneInfo objeto puede representar cualquier zona horaria y los métodos de la TimeZoneInfo clase se pueden usar para convertir la hora en una zona horaria a la hora correspondiente en cualquier otra zona horaria. Los miembros de la TimeZoneInfo clase admiten las siguientes operaciones:

• Recuperar una zona horaria que ya está definida por el sistema operativo.

• Enumeración de las zonas horarias disponibles en un sistema.

• Convertir horas entre diferentes zonas horarias.

• Crear una nueva zona horaria que aún no esté definida por el sistema operativo.

• Serialización de una zona horaria para su recuperación posterior.

Nota

Una instancia de la TimeZoneInfo clase es inmutable. Una vez creado una instancia de un objeto, sus valores no se pueden modificar.

No se puede crear una instancia de un TimeZoneInfo objeto mediante la new palabra clave . En su lugar, debe llamar a uno de los miembros estáticos de la TimeZoneInfo clase que se muestra en la tabla siguiente.

Nombre de miembro estático	Descripción
Método CreateCustomTimeZone	Crea una zona horaria personalizada a partir de datos proporcionados por la aplicación.
Método FindSystemTimeZoneById	Crea una instancia de una zona horaria en función de su identificador.
Método FromSerializedString	Deserializa un valor de cadena para volver a crear un objeto serializado TimeZoneInfo previamente.
Método GetSystemTimeZones	Devuelve una enumerable ReadOnlyCollection<T> de TimeZoneInfo objetos que representa todas las zonas horarias disponibles en el sistema local.
PropiedadLocal	Crea una instancia de un TimeZoneInfo objeto que representa la zona horaria local.
PropiedadUtc	Crea una instancia de un TimeZoneInfo objeto que representa la zona UTC.

Puede usar el CreateCustomTimeZone método para crear una zona horaria que no esté definida en el registro del sistema local en los sistemas Windows o por los datos de zona horaria de la biblioteca ICU en Linux o macOS. A continuación, puede usar la propiedad para guardar la ToSerializedString información del objeto de zona horaria como una cadena, que se puede almacenar en algún formulario al que se pueda acceder a la aplicación. Puede usar el FromSerializedString método para volver a convertir una cadena serializada en un TimeZoneInfo objeto .

Propiedades

BaseUtcOffset	Obtiene la diferencia horaria entre la hora estándar de la zona horaria actual y la hora universal coordinada (hora UTC).
DaylightName	Obtiene el nombre para mostrar del horario de verano de la zona horaria actual.
DisplayName	Obtiene el nombre para mostrar general que representa la zona horaria.
HasIanaId	Devuelve true si este objeto TimeZoneInfo tiene un identificador de IANA.
Id	Obtiene el identificador de la zona horaria.
Local	Obtiene un objeto TimeZoneInfo que representa la zona horaria local.
StandardName	Obtiene el nombre para mostrar de la hora estándar de la zona horaria.
SupportsDaylightSavingTime	Obtiene un valor que indica si la zona horaria tiene alguna regla de horario de verano.
Utc	Obtiene un objeto TimeZoneInfo que representa la zona horaria universal coordinada (hora UTC).

Métodos

ClearCachedData()	Borra los datos de zona horaria almacenados en caché.
ConvertTime(DateTime, TimeZoneInfo)	Convierte una hora en la hora de una zona horaria determinada.
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	Convierte una hora de una zona horaria en otra.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Convierte una hora en la hora de una zona horaria determinada.
ConvertTimeBySystemTimeZoneId(DateTime, String)	Convierte una hora en la hora de otra zona horaria basándose en el identificador de zona horaria.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Convierte una hora de una zona horaria en otra basándose en los identificadores de zona horaria.
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	Convierte una hora en la hora de otra zona horaria basándose en el identificador de zona horaria.
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	Convierte una hora universal coordinada (UTC) en la hora de una zona horaria especificada.
ConvertTimeToUtc(DateTime)	Convierte la fecha y hora especificadas en hora universal coordinada (UTC).
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Convierte la hora de una zona horaria determinada en hora universal coordinada (UTC).
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.
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.
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.
Equals(Object)	Determina si el objeto TimeZoneInfo actual y otro objeto son iguales.
Equals(TimeZoneInfo)	Determina si el objeto TimeZoneInfo actual y otro objeto TimeZoneInfo son iguales.
FindSystemTimeZoneById(String)	Devuelve un TimeZoneInfo objeto basado en su identificador.
FromSerializedString(String)	Deserializa una cadena para volver a crear un objeto TimeZoneInfo serializado original.
GetAdjustmentRules()	Recupera una matriz de objetos TimeZoneInfo.AdjustmentRule que se aplican al objeto TimeZoneInfo actual.
GetAmbiguousTimeOffsets(DateTime)	Devuelve información sobre las posibles fechas y horas a las que se puede asignar una fecha y hora ambigua.
GetAmbiguousTimeOffsets(DateTimeOffset)	Devuelve información sobre las posibles fechas y horas a las que se puede asignar una fecha y hora ambigua.
GetHashCode()	Actúa como una función hash para los algoritmos hash y estructuras de datos como las tablas hash.
GetSystemTimeZones()	Devuelve una colección ordenada de todas las zonas horarias acerca de las cuales hay información disponible en el sistema local.
GetSystemTimeZones(Boolean)	Devuelve un ReadOnlyCollection<T> objeto que contiene todos los timeZone válidos de la máquina local. Este método no inicia TimeZoneNotFoundException ni InvalidTimeZoneException.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
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.
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.
HasSameRules(TimeZoneInfo)	Indica si el objeto actual y otro objeto TimeZoneInfo tienen las mismas reglas de ajuste.
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).
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).
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.
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.
IsInvalidTime(DateTime)	Indica si una fecha y hora determinadas no son válidas.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToSerializedString()	Convierte el objeto TimeZoneInfo actual en una cadena serializada.
ToString()	Devuelve el nombre para mostrar del objeto TimeZoneInfo actual.
TryConvertIanaIdToWindowsId(String, String)	Intenta convertir un identificador de zona horaria de IANA en un identificador de Windows.
TryConvertWindowsIdToIanaId(String, String)	Intenta convertir un identificador de zona horaria de Windows en un identificador de IANA.
TryConvertWindowsIdToIanaId(String, String, String)	Intenta convertir un identificador de zona horaria de Windows en un identificador de IANA.
TryFindSystemTimeZoneById(String, TimeZoneInfo)	Recupera un TimeZoneInfo objeto por nombre de zona horaria.

Implementaciones de interfaz explícitas

IDeserializationCallback.OnDeserialization(Object)	Se ejecuta cuando se completa la deserialización de un objeto.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Rellena un objeto SerializationInfo con los datos necesarios para serializar el objeto TimeZoneInfo actual.