ZonedDateTime 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í.

Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como 2007-12-03T10:15:30+01:00 Europe/Paris.

[Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZonedDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoZonedDateTime

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

Herencia: Object

JavaObject

Object
ZonedDateTime

Atributos: RegisterAttribute

Implementaciones: IJavaObject IJavaPeerable ISerializable IComparable IChronoZonedDateTime ITemporal ITemporalAccessor IDisposable

Comentarios

Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como 2007-12-03T10:15:30+01:00 Europe/Paris.

ZonedDateTime es una representación inmutable de una fecha y hora con una zona horaria. Esta clase almacena todos los campos de fecha y hora, a una precisión de nanosegundos y una zona horaria, con un desplazamiento de zona usado para controlar las fechas y horas locales ambiguas. Por ejemplo, el valor "2º octubre de 2007 a las 13:45.30.123456789 +02:00 en la zona horaria Europa/París" se puede almacenar en .ZonedDateTime

Esta clase controla la conversión de la línea horaria local de LocalDateTime a la línea de tiempo instantánea de Instant. La diferencia entre las dos líneas temporales es el desplazamiento de UTC/Greenwich, representado por .ZoneOffset

La conversión entre las dos líneas temporales implica calcular el desplazamiento mediante el objeto al que ZoneRules rules se accede desde ZoneId. Obtener el desplazamiento de un instante es sencillo, ya que hay exactamente un desplazamiento válido para cada instante. Por el contrario, obtener el desplazamiento de una fecha y hora local no es sencillo. Hay tres casos: <ul><li>Normal, con un desplazamiento válido. Para la gran mayoría del año, se aplica el caso normal, donde hay un único desplazamiento válido para la fecha y hora local.</li><>Li Gap, con cero desplazamientos válidos. Esto es cuando los relojes saltan hacia delante normalmente debido al horario de verano de primavera cambian de "invierno" a "verano". En un intervalo hay valores de fecha y hora locales sin desplazamiento válido.</li><li>Superposición, con dos desplazamientos válidos. Esto es cuando los relojes se vuelven a establecer normalmente debido al horario de verano de otoño cambian de "verano" a "invierno". En una superposición hay valores de fecha y hora locales con dos desplazamientos válidos.</li></ul>

Cualquier método que se convierta directamente o implícitamente de una fecha y hora local a un instante al obtener el desplazamiento tiene la posibilidad de ser complicado.

En el caso de las brechas, la estrategia general es que si la fecha y hora local cae en medio de una brecha, la fecha y hora con zona resultante tendrá un cambio de fecha y hora local por la longitud de la brecha, lo que da lugar a una fecha y hora en el desplazamiento posterior, normalmente "verano".

En el caso de las superposiciones, la estrategia general es que si la fecha y hora local cae en medio de una superposición, se conservará el desplazamiento anterior. Si no hay ningún desplazamiento anterior o el desplazamiento anterior no es válido, se usa el desplazamiento anterior, normalmente "verano". Dos métodos adicionales, #withEarlierOffsetAtOverlap() y #withLaterOffsetAtOverlap(), ayudan a administrar el caso de una superposición.

En términos de diseño, esta clase debe verse principalmente como la combinación de y LocalDateTime .ZoneId ZoneOffset es un elemento vital, pero secundario, de información, que se usa para asegurarse de que la clase representa un instante, especialmente durante una superposición del horario de verano.

Agregado en la versión 1.8.

Java documentación para java.time.ZonedDateTime.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Propiedades

Nombre	Description
Class	Devuelve la clase en tiempo de ejecución de este `Object`objeto . (Heredado de Object)
DayOfMonth	Obtiene el campo día de mes.
DayOfWeek	Obtiene el campo día de la semana, que es una enumeración DayOfWeek.
DayOfYear	Obtiene el campo día de año.
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
Hour	Obtiene el campo hora del día.
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	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
JniPeerMembers	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
Minute	Obtiene el campo minuto de hora.
Month	Obtiene el campo mes de año mediante la enumeración Month.
MonthValue	Obtiene el campo mes de año de 1 a 12.
Nano	Obtiene el campo nano-of-second.
Offset	Obtiene el desplazamiento de zona, como "+01:00".
PeerReference	Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object)
Second	Obtiene el segundo campo de minuto.
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object)
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object)
Year	Obtiene el campo de año.
Zone	Obtiene la zona horaria, como "Europa/París".

Métodos

Nombre	Description
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
CompareTo(Object)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
Construct(JniObjectReference, JniObjectReferenceOptions)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 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()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
Equals(Object)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
Format(DateTimeFormatter)	Da formato a esta fecha y hora mediante el formateador especificado.
From(ITemporalAccessor)	Obtiene una instancia de ZonedDateTime de un objeto temporal.
Get(ITemporalField)	Obtiene el valor del campo especificado a partir de esta fecha y hora como int.
GetHashCode()	Devuelve un valor de código hash para el objeto . (Heredado de Object)
GetLong(ITemporalField)	Obtiene el valor del campo especificado a partir de esta fecha y hora como un largo.
IsSupported(ITemporalField)	Comprueba si se admite el campo especificado.
IsSupported(ITemporalUnit)	Comprueba si se admite la unidad especificada.
JavaFinalize()	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)
Minus(Int64, ITemporalUnit)	Devuelve una copia de esta fecha y hora con la cantidad especificada restada.
Minus(ITemporalAmount)	Devuelve una copia de esta fecha y hora con la cantidad especificada restada.
MinusDays(Int64)	Devuelve una copia de este ZonedDateTime con el número de días especificado restado.
MinusHours(Int64)	Devuelve una copia de zonedDateTime con el número especificado de horas restada.
MinusMinutes(Int64)	Devuelve una copia de zonedDateTime con el número de minutos especificado restado.
MinusMonths(Int64)	Devuelve una copia de zonedDateTime con el número especificado de meses restados.
MinusNanos(Int64)	Devuelve una copia de este ZonedDateTime con el número especificado de nanosegundos restados.
MinusSeconds(Int64)	Devuelve una copia de zonedDateTime con el número de segundos especificado restado.
MinusWeeks(Int64)	Devuelve una copia de zonedDateTime con el número especificado de semanas restada.
MinusYears(Int64)	Devuelve una copia de este ZonedDateTime con el número de años especificado restado.
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)
Now()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
Now(Clock)	Obtiene la fecha y hora actuales del reloj especificado.
Now(ZoneId)	Obtiene la fecha y hora actuales del reloj del sistema en la zona horaria especificada.
Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId)	Obtiene una instancia de ZonedDateTime de un año, mes, día, hora, minuto, segundo, nanosegundos y zona horaria.
Of(LocalDate, LocalTime, ZoneId)	Obtiene una instancia de ZonedDateTime de una fecha y hora locales.
Of(LocalDateTime, ZoneId)	Obtiene una instancia de ZonedDateTime de una fecha y hora local.
OfInstant(Instant, ZoneId)	Obtiene una instancia de ZonedDateTime de un instante.
OfInstant(LocalDateTime, ZoneOffset, ZoneId)	Obtiene una instancia de ZonedDateTime del instante formado mediante la combinación de la fecha y el desplazamiento locales.
OfLocal(LocalDateTime, ZoneId, ZoneOffset)	Obtiene una instancia de ZonedDateTime de una fecha y hora local mediante el desplazamiento preferido si es posible.
OfStrict(LocalDateTime, ZoneOffset, ZoneId)	Obtiene una instancia de ZonedDateTime que valida estrictamente la combinación de fecha y hora local, desplazamiento e identificador de zona.
Parse(ICharSequence, DateTimeFormatter)	Obtiene una instancia de ZonedDateTime de una cadena de texto mediante un formateador específico.
Parse(ICharSequence)	Obtiene una instancia de ZonedDateTime de una cadena de texto como 2007-12-03T10:15:30+01:00[Europa/París].
Parse(String, DateTimeFormatter)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
Parse(String)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
Plus(Int64, ITemporalUnit)	Devuelve una copia de esta fecha y hora con la cantidad especificada agregada.
Plus(ITemporalAmount)	Devuelve una copia de esta fecha y hora con la cantidad especificada agregada.
PlusDays(Int64)	Devuelve una copia de zonedDateTime con el número de días especificado agregado.
PlusHours(Int64)	Devuelve una copia de zonedDateTime con el número especificado de horas agregadas.
PlusMinutes(Int64)	Devuelve una copia de este ZonedDateTime con el número especificado de minutos agregados.
PlusMonths(Int64)	Devuelve una copia de zonedDateTime con el número especificado de meses agregados.
PlusNanos(Int64)	Devuelve una copia de zonedDateTime con el número especificado de nanosegundos agregados.
PlusSeconds(Int64)	Devuelve una copia de zonedDateTime con el número de segundos especificado agregado.
PlusWeeks(Int64)	Devuelve una copia de zonedDateTime con el número especificado de semanas agregadas.
PlusYears(Int64)	Devuelve una copia de zonedDateTime con el número especificado de años agregados.
Query(ITemporalQuery)	Consulta esta fecha y hora mediante la consulta especificada.
Range(ITemporalField)	Obtiene el intervalo de valores válidos para el campo especificado.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
ToArray<T>()	Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object)
ToLocalDate()	Obtiene la parte LocalDate de esta fecha y hora.
ToLocalDateTime()	Obtiene la parte LocalDateTime de esta fecha y hora.
ToLocalTime()	Obtiene la parte LocalTime de esta fecha y hora.
ToOffsetDateTime()	Convierte esta fecha y hora en offsetDateTime.
ToString()	Devuelve una representación de cadena del objeto . (Heredado de Object)
TruncatedTo(ITemporalUnit)	Devuelve una copia de zonedDateTime con la hora truncada.
UnregisterFromRuntime()	Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object)
Until(ITemporal, ITemporalUnit)	Calcula la cantidad de tiempo hasta otra fecha y hora en términos de la unidad especificada.
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)
With(ITemporalAdjuster)	Devuelve una copia ajustada de esta fecha y hora.
With(ITemporalField, Int64)	Devuelve una copia de esta fecha y hora con el campo especificado establecido en un nuevo valor.
WithDayOfMonth(Int32)	Devuelve una copia de zonedDateTime con el día del mes modificado.
WithDayOfYear(Int32)	Devuelve una copia de zonedDateTime con el día del año modificado.
WithEarlierOffsetAtOverlap()	Devuelve una copia de esta fecha y hora que cambia el desplazamiento de zona a la anterior de los dos desplazamientos válidos en una superposición de línea horaria local.
WithFixedOffsetZone()	Devuelve una copia de esta fecha y hora con el identificador de zona establecido en el desplazamiento.
WithHour(Int32)	Devuelve una copia de zonedDateTime con la hora del día modificada.
WithLaterOffsetAtOverlap()	Devuelve una copia de esta fecha y hora que cambia el desplazamiento de zona a la posterior de los dos desplazamientos válidos en una superposición de línea horaria local.
WithMinute(Int32)	Devuelve una copia de zonedDateTime con el minuto de hora modificado.
WithMonth(Int32)	Devuelve una copia de zonedDateTime con el mes de año modificado.
WithNano(Int32)	Devuelve una copia de zonedDateTime con la nano-of-second altered.
WithSecond(Int32)	Devuelve una copia de este ZonedDateTime con el segundo minuto modificado.
WithYear(Int32)	Devuelve una copia de este ZonedDateTime con el año modificado.
WithZoneSameInstant(ZoneId)	Devuelve una copia de esta fecha y hora con una zona horaria diferente, conservando el instante.
WithZoneSameLocal(ZoneId)	Devuelve una copia de esta fecha y hora con una zona horaria diferente, conservando la fecha y hora local si es posible.

Implementaciones de interfaz explícitas

Nombre	Description
IChronoZonedDateTime.Plus(Int64, ITemporalUnit)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.ToLocalDateTime()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.With(ITemporalField, Int64)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithEarlierOffsetAtOverlap()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithLaterOffsetAtOverlap()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithZoneSameInstant(ZoneId)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithZoneSameLocal(ZoneId)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`.
IJavaPeerable.Disposed()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.Finalized()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 Europe/Paris`. (Heredado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 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)	Una fecha y hora con una zona horaria en el sistema de calendario ISO-8601, como `2007-12-03T10:15:30+01:00 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