ITemporal Interfaz
Definición
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í.
Interfaz de nivel de marco que define el acceso de lectura y escritura a un objeto temporal, como una fecha, hora, desplazamiento o alguna combinación de estos.
[Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)]
public interface ITemporal : IDisposable, Java.Interop.IJavaPeerable, Java.Time.Temporal.ITemporalAccessor
[<Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)>]
type ITemporal = interface
interface ITemporalAccessor
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Derivado
- Atributos
- Implementaciones
Comentarios
Interfaz de nivel de marco que define el acceso de lectura y escritura a un objeto temporal, como una fecha, hora, desplazamiento o alguna combinación de estos.
Este es el tipo de interfaz base para los objetos de fecha, hora y desplazamiento que se completan lo suficiente para manipularse mediante plus y menos. Se implementa mediante esas clases que pueden proporcionar y manipular información como campos TemporalField o consultas TemporalQuery. Consulte TemporalAccessor
la versión de solo lectura de esta interfaz.
La mayoría de la información de fecha y hora se pueden representar como un número. Se modelan mediante TemporalField
con el número mantenido mediante un long
para controlar valores grandes. Año, mes y día de mes son ejemplos sencillos de campos, pero también incluyen desplazamientos instantáneos. Consulte ChronoField
para conocer el conjunto estándar de campos.
No se pueden representar dos fragmentos de información de fecha y hora por números, la cronología java.time.chrono.Chronology y la zona horaria java.time.ZoneId. Se puede acceder a ellos mediante #query(TemporalQuery) queries
el uso de los métodos estáticos definidos en TemporalQuery
.
Esta interfaz es una interfaz de nivel de marco que no debe usarse ampliamente en el código de la aplicación. En su lugar, las aplicaciones deben crear y pasar instancias de tipos concretos, como LocalDate
. Hay muchas razones para esto, parte de la cual es que las implementaciones de esta interfaz pueden estar en sistemas de calendario distintos de ISO. Consulte java.time.chrono.ChronoLocalDate
para obtener una explicación más completa de los problemas.
<h2>Cuándo implementar</h2>
Una clase debe implementar esta interfaz si cumple tres criterios: ul>li proporciona acceso a la información de fecha, hora y desplazamiento, según TemporalAccessor
<li>, el conjunto de campos es contiguo del más grande al más pequeño><, se completa el conjunto de campos, de modo que no se necesita ningún otro campo para definir el intervalo válido de valores para los campos representados </ul.><<>
Cuatro ejemplos hacen que esto quede claro: <ul><li>LocalDate
implementa esta interfaz, ya que representa un conjunto de campos que son contiguos de días a para siempre y no requieren información externa para determinar la validez de cada fecha. Por lo tanto, es capaz de implementar correctamente más/menos. <li>LocalTime
implementa esta interfaz, ya que representa un conjunto de campos que son contiguos de nanos a dentro de los días y no requieren información externa para determinar la validez. Es capaz de implementar más/menos correctamente, ajustando alrededor del día. <li>MonthDay
, la combinación de mes de año y día de mes, no implementa esta interfaz. Aunque la combinación es contigua, de días a meses en años, la combinación no tiene suficiente información para definir el intervalo válido de valores para el día del mes. Por lo tanto, no se puede implementar correctamente más/menos. <li>La combinación del día de la semana y el día del mes ("viernes el 13") no debe implementar esta interfaz. No representa un conjunto contiguo de campos, ya que días a semanas se superponen días a meses. </ul>
Se ha agregado en la versión 1.8.
Documentación de Java para java.time.temporal.Temporal
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código Project y que se usan según los términos Creative Commons 2.5 Attribution License.
Propiedades
Handle |
Obtiene el valor JNI del objeto Android subyacente. (Heredado de IJavaObject) |
JniIdentityHashCode |
Devuelve el valor de |
JniManagedPeerState |
Estado del mismo nivel administrado. (Heredado de IJavaPeerable) |
JniPeerMembers |
Compatibilidad con la invocación y el acceso de miembros. (Heredado de IJavaPeerable) |
PeerReference |
Devuelve una JniObjectReference de la instancia de objeto Java ajustada. (Heredado de IJavaPeerable) |
Métodos
Disposed() |
Se llama cuando se ha eliminado la instancia. (Heredado de IJavaPeerable) |
DisposeUnlessReferenced() |
Si no hay referencias pendientes a esta instancia, llama a |
Finalized() |
Se llama cuando se ha finalizado la instancia. (Heredado de IJavaPeerable) |
Get(ITemporalField) |
Obtiene el valor del campo especificado como . |
GetLong(ITemporalField) |
Obtiene el valor del campo especificado como . |
IsSupported(ITemporalField) |
Comprueba si se admite el campo especificado. (Heredado de ITemporalAccessor) |
IsSupported(ITemporalUnit) |
Comprueba si se admite la unidad especificada. |
Minus(Int64, ITemporalUnit) |
Devuelve un objeto del mismo tipo que este objeto con el período especificado restado. |
Minus(ITemporalAmount) |
Devuelve un objeto del mismo tipo que este objeto con una cantidad restada. |
Plus(Int64, ITemporalUnit) |
Devuelve un objeto del mismo tipo que este objeto con el período especificado agregado. |
Plus(ITemporalAmount) |
Devuelve un objeto del mismo tipo que este objeto con una cantidad agregada. |
Query(ITemporalQuery) |
Consulta esta fecha y hora. (Heredado de ITemporalAccessor) |
Range(ITemporalField) |
Obtiene el intervalo de valores válidos para el campo especificado. (Heredado de ITemporalAccessor) |
SetJniIdentityHashCode(Int32) |
Establezca el valor devuelto por |
SetJniManagedPeerState(JniManagedPeerStates) |
Interfaz de nivel de marco que define el acceso de lectura y escritura a un objeto temporal, como una fecha, hora, desplazamiento o alguna combinación de estos. (Heredado de IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Establezca el valor devuelto por |
UnregisterFromRuntime() |
Anule el registro de esta instancia para que el tiempo de ejecución no lo devuelva de invocaciones futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Heredado de IJavaPeerable) |
Until(ITemporal, ITemporalUnit) |
Calcula la cantidad de tiempo hasta que otro temporal en términos de la unidad especificada. |
With(ITemporalAdjuster) |
Devuelve un objeto ajustado del mismo tipo que este objeto con el ajuste realizado. |
With(ITemporalField, Int64) |
Devuelve un objeto del mismo tipo que este objeto con el campo especificado modificado. |
Métodos de extensión
JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
JavaCast<TResult>(IJavaObject) |
Interfaz de nivel de marco que define el acceso de lectura y escritura a un objeto temporal, como una fecha, hora, desplazamiento o alguna combinación de estos. |
GetJniTypeName(IJavaPeerable) |
Interfaz de nivel de marco que define el acceso de lectura y escritura a un objeto temporal, como una fecha, hora, desplazamiento o alguna combinación de estos. |