IChronology Interfaccia

Definizione

[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

Derivato

Java.Time.Chrono.AbstractChronology

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IComparable IDisposable

Commenti

Sistema di calendario, utilizzato per organizzare e identificare le date.

L'API principale di data e ora è basata sul sistema di calendario ISO. La cronologia opera dietro le quinte per rappresentare il concetto generale di un sistema di calendario. Ad esempio, il giapponese, Minguo, buddista thai e altri.

La maggior parte degli altri sistemi di calendario opera anche sui concetti condivisi dell'anno, del mese e del giorno, collegati ai cicli della Terra intorno al Sole e alla Luna intorno alla Terra. Questi concetti condivisi sono definiti da ChronoField e sono disponibili per l'uso da qualsiasi Chronology implementazione:

LocalDate isoDate = ...
              ThaiBuddhistDate thaiDate = ...
              int isoYear = isoDate.get(ChronoField.YEAR);
              int thaiYear = thaiDate.get(ChronoField.YEAR);

Come illustrato, anche se gli oggetti data si trovano in sistemi di calendario diversi, rappresentati da istanze diverse Chronology , entrambi possono essere sottoposti a query usando la stessa costante in ChronoField. Per una descrizione completa delle implicazioni di questa operazione, vedere ChronoLocalDate. In generale, il consiglio consiste nell'usare il noto basato su LocalDateISO anziché ChronoLocalDate.

Sebbene un Chronology oggetto usi ChronoField in genere e si basa su un modello era, year-of-era, month-of-year, day-of-month di una data, questo non è obbligatorio. Un'istanza Chronology può rappresentare un tipo completamente diverso di sistema di calendario, ad esempio il Mayan.

In termini pratici, l'istanza Chronology funge anche da factory. Il #of(String) metodo consente di cercare un'istanza in base all'identificatore, mentre il #ofLocale(Locale) metodo consente la ricerca in base alle impostazioni locali.

L'istanza Chronology fornisce un set di metodi per creare ChronoLocalDate istanze. Le classi date vengono utilizzate per modificare date specifiche. <ul><li>#dateNow(Clock) dateNow(clock)><<#dateNow() dateNow()li<>#dateNow(ZoneId) dateNow(zone)<>#date(int, int, int) date(yearProleptic, month, day)>><<#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)<>#date(Era, int, int, int) date(era, yearOfEra, month, day)/ul>#date(TemporalAccessor) date(TemporalAccessor)<>

<h2 id="addcalendars">Aggiunta di nuovi calendari</h2> Il set di cronologie disponibili può essere esteso dalle applicazioni. L'aggiunta di un nuovo sistema di calendario richiede la scrittura di un'implementazione di ChronologyChronoLocalDate e Era. La maggior parte della logica specifica per il sistema di calendario sarà nell'implementazione ChronoLocalDate . L'implementazione Chronology funge da factory.

Per consentire l'individuazione di cronologie aggiuntive, viene utilizzato .java.util.ServiceLoader ServiceLoader È necessario aggiungere un file alla META-INF/services directory con il nome 'java.time.chrono.Chronology' che elenca le classi di implementazione. Per altri dettagli sul caricamento del servizio, vedere ServiceLoader. Per la ricerca in base all'ID o calendarType, i calendari forniti dal sistema vengono trovati prima seguiti dai calendari forniti dall'applicazione.

Ogni cronologia deve definire un ID cronologia univoco all'interno del sistema. Se la cronologia rappresenta un sistema di calendario definito dalla specifica CLDR, il tipo di calendario è la concatenazione del tipo CLDR e, se applicabile, la variante CLDR.

Aggiunta nella versione 1.8.

Documentazione java per java.time.chrono.Chronology.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.