IChronology 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í.
Un sistema de calendario, que se usa para organizar e identificar fechas.
[Android.Runtime.Register("java/time/chrono/Chronology", "", "Java.Time.Chrono.IChronologyInvoker", ApiSince=26)]
public interface IChronology : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable
[<Android.Runtime.Register("java/time/chrono/Chronology", "", "Java.Time.Chrono.IChronologyInvoker", ApiSince=26)>]
type IChronology = interface
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Derivado
- Atributos
- Implementaciones
Comentarios
Un sistema de calendario, que se usa para organizar e identificar fechas.
La API de fecha y hora principal se basa en el sistema de calendario ISO. La cronología funciona en segundo plano para representar el concepto general de un sistema de calendario. Por ejemplo, los japoneses, Minguo, budista tailandés y otros.
La mayoría de los demás sistemas de calendario también operan en los conceptos compartidos de año, mes y día, vinculados a los ciclos de la Tierra alrededor del Sol, y la Luna alrededor de la Tierra. Estos conceptos compartidos se definen mediante ChronoField
y están disponibles para su uso por cualquier Chronology
implementación:
LocalDate isoDate = ...
ThaiBuddhistDate thaiDate = ...
int isoYear = isoDate.get(ChronoField.YEAR);
int thaiYear = thaiDate.get(ChronoField.YEAR);
Como se muestra, aunque los objetos date están en sistemas de calendario diferentes, representados por instancias diferentes Chronology
, ambos se pueden consultar mediante la misma constante en ChronoField
. Para obtener una explicación completa de las implicaciones de esto, vea ChronoLocalDate
. En general, el consejo es usar el conocido basado en LocalDate
ISO, en lugar de ChronoLocalDate
.
Aunque un Chronology
objeto normalmente usa ChronoField
y se basa en un modelo de era, año de era, mes de año, día de mes de mes de una fecha, esto no es necesario. Una Chronology
instancia puede representar un sistema de calendario totalmente diferente, como el Maya.
En términos prácticos, la Chronology
instancia también actúa como fábrica. El #of(String)
método permite buscar una instancia por identificador, mientras que el #ofLocale(Locale)
método permite la búsqueda por configuración regional.
La Chronology
instancia proporciona un conjunto de métodos para crear ChronoLocalDate
instancias. Las clases de fecha se usan para manipular fechas específicas. <ul><li><<>#date(int, int, int) date(yearProleptic, month, day)
><#date(Era, int, int, int) date(era, yearOfEra, month, day)
#dateNow(ZoneId) dateNow(zone)
><><#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)
#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)
>#date(TemporalAccessor) date(TemporalAccessor)
#dateNow() dateNow()
><<#dateNow(Clock) dateNow(clock)
<>/ul>
<h2 id="addcalendars">Adding New Calendars</h2> The set of available chronologies can be extended by applications. Agregar un nuevo sistema de calendario requiere la escritura de una implementación de Chronology
y ChronoLocalDate
Era
. La mayoría de la lógica específica del sistema de calendario estará en la ChronoLocalDate
implementación. La Chronology
implementación actúa como fábrica.
Para permitir la detección de cronologías adicionales, se utiliza .java.util.ServiceLoader ServiceLoader
Se debe agregar un archivo al META-INF/services
directorio con el nombre "java.time.chrono.Chronology" que enumera las clases de implementación. Consulte ServiceLoader para obtener más información sobre la carga del servicio. Para la búsqueda por id o calendarType, los calendarios proporcionados por el sistema se encuentran primero seguidos de los calendarios proporcionados por la aplicación.
Cada cronología debe definir un identificador de cronología único dentro del sistema. Si la cronología representa un sistema de calendario definido por la especificación CLDR, el tipo de calendario es la concatenación del tipo CLDR y, si procede, la variante CLDR.
Se ha agregado en la versión 1.8.
Documentación de Java para java.time.chrono.Chronology
.
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
AvailableChronologies |
Devuelve las cronologías disponibles. |
CalendarType |
Un sistema de calendario, que se usa para organizar e identificar fechas. |
Handle |
Obtiene el valor JNI del objeto Android subyacente. (Heredado de IJavaObject) |
Id |
Un sistema de calendario, que se usa para organizar e identificar fechas. |
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
CompareTo(IChronology) |
Compara esta cronología con otra cronología. |
CompareTo(Object) |
Compara este objeto con el objeto especificado para el orden. (Heredado de IComparable) |
Date(IEra, Int32, Int32, Int32) |
Obtiene una fecha local en esta cronología de los campos era, año de era, mes de año y día de mes. |
Date(Int32, Int32, Int32) |
Obtiene una fecha local en esta cronología de los campos proleptic-year, month-of-year y day-of-month. |
Date(ITemporalAccessor) |
Obtiene una fecha local en esta cronología de otro objeto temporal. |
DateEpochDay(Int64) |
Obtiene una fecha local en esta cronología del día de la época. |
DateNow() |
Obtiene la fecha local actual en esta cronología del reloj del sistema en la zona horaria predeterminada. |
DateNow(Clock) |
Obtiene la fecha local actual en esta cronología del reloj especificado. |
DateNow(ZoneId) |
Obtiene la fecha local actual en esta cronología del reloj del sistema en la zona horaria especificada. |
DateYearDay(IEra, Int32, Int32) |
Obtiene una fecha local en esta cronología de los campos era, año de era y día de año. |
DateYearDay(Int32, Int32) |
Obtiene una fecha local en esta cronología de los campos proléptico y día de año. |
Disposed() |
Se llama cuando se ha eliminado la instancia. (Heredado de IJavaPeerable) |
DisposeUnlessReferenced() |
Si no hay referencias pendientes a esta instancia, llama a |
EpochSecond(IEra, Int32, Int32, Int32, Int32, Int32, Int32, ZoneOffset) |
Obtiene el número de segundos de la época de 1970-01-01T00:00:00Z. |
EpochSecond(Int32, Int32, Int32, Int32, Int32, Int32, ZoneOffset) |
Obtiene el número de segundos de la época de 1970-01-01T00:00:00Z. |
Equals(Object) |
Comprueba si esta cronología es igual a otra cronología. |
EraOf(Int32) |
Crea el objeto de era de cronología a partir del valor numérico. |
Eras() |
Obtiene la lista de eras para la cronología. |
Finalized() |
Se llama cuando se ha finalizado la instancia. (Heredado de IJavaPeerable) |
From(ITemporalAccessor) |
Obtiene una instancia de |
GetDisplayName(TextStyle, Locale) |
Obtiene la representación textual de esta cronología. |
GetHashCode() |
Código hash para esta cronología. |
IsLeapYear(Int64) |
Comprueba si el año especificado es un año bisiesto. |
LocalDateTime(ITemporalAccessor) |
Obtiene una fecha y hora local en esta cronología de otro objeto temporal. |
Of(String) |
Obtiene una instancia de a partir de |
OfLocale(Locale) |
Obtiene una instancia de |
Period(Int32, Int32, Int32) |
Obtiene un período para esta cronología basándose en años, meses y días. |
ProlepticYear(IEra, Int32) |
Calcula el año proléptico según la era y el año de la era. |
Range(ChronoField) |
Obtiene el intervalo de valores válidos para el campo especificado. |
ResolveDate(IDictionary<ITemporalField,Long>, ResolverStyle) |
Resuelve los valores analizados |
SetJniIdentityHashCode(Int32) |
Establezca el valor devuelto por |
SetJniManagedPeerState(JniManagedPeerStates) |
Un sistema de calendario, que se usa para organizar e identificar fechas. (Heredado de IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Establezca el valor devuelto por |
ToString() |
Genera esta cronología como . |
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) |
ZonedDateTime(Instant, ZoneId) |
Obtiene un |
ZonedDateTime(ITemporalAccessor) |
Obtiene un |
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) |
Un sistema de calendario, que se usa para organizar e identificar fechas. |
GetJniTypeName(IJavaPeerable) |
Un sistema de calendario, que se usa para organizar e identificar fechas. |