ZoneId Clase

Definición

Espacio de nombres:: Java.Time

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Un identificador de zona horaria, como Europe/Paris.

[Android.Runtime.Register("java/time/ZoneId", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class ZoneId : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/time/ZoneId", ApiSince=26, DoNotGenerateAcw=true)>]
type ZoneId = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herencia: Object

JavaObject

Object
ZoneId

Derivado: Java.Time.ZoneOffset

Atributos: RegisterAttribute

Implementaciones: IJavaObject IJavaPeerable ISerializable IDisposable

Comentarios

Un identificador de zona horaria, como Europe/Paris.

ZoneId Se usa para identificar las reglas usadas para convertir entre y Instant .LocalDateTime Hay dos tipos distintos de identificador: <los desplazamientos fijos ul><li>: un desplazamiento totalmente resuelto de UTC/Greenwich, que usa el mismo desplazamiento para todas las regiones geográficas de fecha y hora <local,>un área donde un conjunto específico de reglas para buscar el desplazamiento de UTC/Greenwich aplican </ul> La mayoría de desplazamientos fijos se representan mediante ZoneOffset. Al llamar #normalized() a en cualquierZoneId, se asegurará de que un identificador de desplazamiento fijo se represente como .ZoneOffset

Las reglas reales, que describen cuándo y cómo cambia el desplazamiento, se definen mediante ZoneRules. Esta clase es simplemente un identificador que se usa para obtener las reglas subyacentes. Este enfoque se toma porque las reglas se definen por los gobiernos y cambian con frecuencia, mientras que el identificador es estable.

La distinción tiene otros efectos. Serializar el ZoneId solo enviará el identificador, mientras que serializar las reglas envía todo el conjunto de datos. De forma similar, una comparación de dos identificadores solo examina el identificador, mientras que una comparación de dos reglas examina todo el conjunto de datos.

<h2>Identificadores< de zona horaria/h2> El identificador es único dentro del sistema. Hay tres tipos de identificadores.

El tipo más sencillo de id. es el de ZoneOffset. Esto consta de "Z" e identificadores que comienzan por "+" o "-".

El siguiente tipo de identificador son identificadores de estilo de desplazamiento con algún tipo de prefijo, como "GMT+2" o "UTC+01:00". Los prefijos reconocidos son "UTC", "GMT" y "UT". El desplazamiento es el sufijo y se normalizará durante la creación. Estos identificadores se pueden normalizar en un ZoneOffset mediante normalized().

El tercer tipo de identificador son identificadores basados en regiones. Un identificador basado en regiones debe tener dos o más caracteres y no empezar por "UTC", "GMT", "UT" "+" o "-". Los identificadores basados en regiones se definen mediante la configuración. La configuración se centra en proporcionar la búsqueda del identificador al subyacente ZoneRules.

Las reglas de zona horaria se definen por los gobiernos y cambian con frecuencia. Hay una serie de organizaciones, conocidas aquí como grupos, que supervisan los cambios de zona horaria y los intercalan. El grupo predeterminado es la base de datos de zona horaria de IANA (TZDB). Otras organizaciones incluyen IATA (el cuerpo de la industria aérea) y Microsoft.

Cada grupo define su propio formato para el identificador de región que proporciona. El grupo TZDB define identificadores como "Europa/Londres" o "America/New_York". Los identificadores de TZDB tienen prioridad sobre otros grupos.

Se recomienda encarecidamente que el nombre del grupo se incluya en todos los identificadores proporcionados por grupos distintos de TZDB para evitar conflictos. Por ejemplo, los identificadores de región horaria de la aerolínea IATA suelen ser los mismos que el código de aeropuerto de tres letras. Sin embargo, el aeropuerto de Budapest tiene el código "UTC", que obviamente es un conflicto. El formato recomendado para los identificadores de región de grupos distintos de TZDB es "group~region". Por lo tanto, si se definieron los datos de IATA, el aeropuerto de Budapest sería 'IATA~UTC'.

<h2>Serialization</h2> Esta clase se puede serializar y almacena el identificador de zona de cadena en el formulario externo. La ZoneOffset subclase usa un formato dedicado que solo almacena el desplazamiento de UTC/Greenwich.

Se ZoneId puede deserializar en un entorno de ejecución de Java donde se desconoce el identificador. Por ejemplo, si se ha actualizado un Java runtime del lado servidor con un nuevo identificador de zona, pero el Java runtime del lado cliente no se ha actualizado. En este caso, el ZoneId objeto existirá y se puede consultar mediante getId, equals, hashCode, toStringy getDisplayNamenormalized. Sin embargo, se producirá un error en cualquier llamada a getRules con ZoneRulesException. Este enfoque está diseñado para permitir ZonedDateTime que se cargue y se consulte, pero no se modifique, en un entorno de ejecución de Java con información de zona horaria incompleta.

Agregado en la versión 1.8.

Java documentación para java.time.ZoneId.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Constructores

Nombre	Description
ZoneId(IntPtr, JniHandleOwnership)	Un identificador de zona horaria, como `Europe/Paris`.

Propiedades

Nombre	Description
AvailableZoneIds	Obtiene el conjunto de identificadores de zona disponibles.
Class	Devuelve la clase en tiempo de ejecución de este `Object`objeto . (Heredado de Object)
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
Id	Obtiene el identificador de zona horaria único.
JniIdentityHashCode	Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object)
JniManagedPeerState	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
JniPeerMembers	Un identificador de zona horaria, como `Europe/Paris`.
PeerReference	Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object)
Rules	Obtiene las reglas de zona horaria para este identificador que permiten realizar cálculos.
ShortIds	Un identificador de zona horaria, como `Europe/Paris`.
ThresholdClass	Un identificador de zona horaria, como `Europe/Paris`.
ThresholdType	Un identificador de zona horaria, como `Europe/Paris`.

Métodos

Nombre	Description
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
Dispose()	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
Dispose(Boolean)	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
DisposeUnlessReferenced()	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
Equals(Object)	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
From(ITemporalAccessor)	Obtiene una instancia de ZoneId de un objeto temporal.
GetDisplayName(TextStyle, Locale)	Obtiene la representación textual de la zona, como "Hora británica" o "+02:00".
GetHashCode()	Devuelve un valor de código hash para el objeto . (Heredado de Object)
JavaFinalize()	Obsoletos. Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object)
Normalized()	Normaliza el identificador de zona horaria, devolviendo un ZoneOffset siempre que sea posible.
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
Of(String, IDictionary<String,String>)	Obtiene una instancia de ZoneId mediante su identificador mediante un mapa de alias para complementar los identificadores de zona estándar.
Of(String)	Obtiene una instancia de ZoneId de un identificador que garantiza que el identificador es válido y está disponible para su uso.
OfOffset(String, ZoneOffset)	Obtiene una instancia de ZoneId que ajusta un desplazamiento.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
SystemDefault()	Un identificador de zona horaria, como `Europe/Paris`.
ToArray<T>()	Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto . (Heredado de Object)
UnregisterFromRuntime()	Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
IJavaPeerable.Disposed()	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.Finalized()	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Un identificador de zona horaria, como `Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Un identificador de zona horaria, como `Europe/Paris`.

Métodos de extensión

Nombre	Description
GetJniTypeName(IJavaPeerable)	Obtiene el nombre JNI del tipo de la instancia `self`.
JavaAs<TResult>(IJavaPeerable)	Intente coerción `self` para escribir `TResult`, comprobando que la coerción es válida en el lado de Java.
JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Un identificador de zona horaria, como `Europe/Paris`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Intente coerción `self` para escribir `TResult`, comprobando que la coerción es válida en el lado de Java.

Se aplica a