IChronology Interfaz

Definición

[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

Java.Time.Chrono.AbstractChronology

Atributos

RegisterAttribute

Implementaciones

IJavaObject IJavaPeerable IComparable IDisposable

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 calendarios 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 de fecha están en sistemas de calendario diferentes, representados por instancias diferentes Chronology , ambos se pueden consultar con la misma constante en ChronoField. Para obtener una explicación completa de las implicaciones de esto, vea ChronoLocalDate. En general, el consejo consiste en usar el conocido basado en LocalDateISO, en lugar de ChronoLocalDate.

Aunque un Chronology objeto normalmente usa ChronoField y se basa en un modelo de fecha, 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(Era, int, int, int) date(era, yearOfEra, month, day)#date(int, int, int) date(yearProleptic, month, day)#dateNow(ZoneId) dateNow(zone)<>#dateNow(Clock) dateNow(clock)<<>><<#dateNow() dateNow()>li><#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)li#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)<><>#date(TemporalAccessor) date(TemporalAccessor)/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 Chronologyy ChronoLocalDateEra. 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, java.util.ServiceLoader ServiceLoader se utiliza . 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 calendarios proporcionados por la aplicación.

Cada cronología debe definir un identificador de cronología que sea ú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.

Agregado en la versión 1.8.

Java documentación para java.time.chrono.Chronology.

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.