Esta documentación está archivada y no tiene mantenimiento.

TimeZoneInfo (Clase)

Actualización: noviembre 2007

Representa cualquier zona horaria del mundo.

Espacio de nombres:  System
Ensamblado:  System.Core (en System.Core.dll)

[SerializableAttribute]
[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, 
	ISerializable, IDeserializationCallback
/** @attribute SerializableAttribute */ 
/** @attribute HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true) */
public final class TimeZoneInfo implements IEquatable<TimeZoneInfo>, 
	ISerializable, IDeserializationCallback
public final class TimeZoneInfo implements IEquatable<TimeZoneInfo>, ISerializable, IDeserializationCallback

Bb396389.alert_note(es-es,VS.90).gifNota:

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de la propiedad Resources: MayLeakOnAbort. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación de SQL Server y atributos de protección del host.

Una zona horaria es una región geográfica donde se utiliza la misma hora.

La clase TimeZoneInfo ofrece mejoras significativas con respecto a la clase TimeZone, que sólo proporciona una funcionalidad limitada.

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

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

  • Enumerar las zonas horarias que están disponibles en un sistema.

  • Convertir las horas entre zonas horarias distintas.

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

  • Serializar una zona horaria para la recuperación posterior.

Bb396389.alert_note(es-es,VS.90).gifNota:

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

No puede crear instancias de un objeto TimeZoneInfo utilizando la palabra clave new. En su lugar, debe llamar a uno de los miembros estáticos de la clase TimeZoneInfo mostrados en la tabla siguiente.

Nombre de miembro estático

Descripción

Método CreateCustomTimeZone

Crea una zona horaria personalizada a partir de los datos proporcionados por la aplicación.

Método FindSystemTimeZoneById

Crea instancias de una zona horaria definida en el Registro del sistema basándose en el identificador de la zona.

Método FromSerializedString

Deserializa un valor de cadena para volver a crear un objeto TimeZoneInfo previamente serializado.

Método GetSystemTimeZones

Devuelve una colección ReadOnlyCollection<T> enumerable de objetos TimeZoneInfo que representa todas las zonas horarias que están disponibles en el sistema local.

Propiedad Local

Crea una instancia de un objeto TimeZoneInfo que representa la zona horaria local.

Propiedad Utc

Crea instancias de un objeto TimeZoneInfo que representa la zona de hora UTC.

Puede utilizar el método CreateCustomTimeZone para crear una zona horaria no definida en el Registro del sistema local. Luego puede utilizar la propiedad ToSerializedString para guardar la información del objeto de zona horaria como una cadena, que se puede almacenar de alguna forma accesible para la aplicación. Puede utilizar el método FromSerializedString para convertir una cadena serializada de nuevo en un objeto TimeZoneInfo.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5
Mostrar: