IChronology Schnittstelle

Definition

[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

Abgeleitet

Java.Time.Chrono.AbstractChronology

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IComparable IDisposable

Hinweise

Ein Kalendersystem, das zum Organisieren und Identifizieren von Datumsangaben verwendet wird.

Die Wichtigste Datums- und Uhrzeit-API basiert auf dem ISO-Kalendersystem. Die Chronologie arbeitet hinter den Kulissen, um das allgemeine Konzept eines Kalendersystems darzustellen. Beispielsweise die Japanischen, Minguo, Thai-Buddhisten und andere.

Die meisten anderen Kalendersysteme arbeiten auch an den gemeinsamen Konzepten von Jahr, Monat und Tag, die mit den Zyklen der Erde um die Sonne und den Mond um die Erde verbunden sind. Diese gemeinsam genutzten Konzepte werden durch ChronoField eine beliebige Chronology Implementierung definiert und stehen zur Verwendung zur Verfügung:

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

Wie gezeigt, obwohl sich die Datumsobjekte in verschiedenen Kalendersystemen befinden, dargestellt durch unterschiedliche Chronology Instanzen, können beide mit der gleichen Konstante abgefragt werden.ChronoField Eine vollständige Erläuterung der Auswirkungen dieses Themas finden Sie unter ChronoLocalDate. Im Allgemeinen empfiehlt es sich, die bekannten ISO-basierten LocalDateanstelle von ChronoLocalDate.

Chronology Ein Objekt verwendet ChronoField und basiert in der Regel auf einer Ära, einer Jahres-, Monats-of-Year-, Tag-of-Month-Modell eines Datums, dies ist jedoch nicht erforderlich. Eine Chronology Instanz kann eine völlig andere Art von Kalendersystem darstellen, z. B. den Mayan.

In der Praxis fungiert die Chronology Instanz auch als Fabrik. Mit der #of(String) Methode kann eine Instanz anhand des Bezeichners nachschlagen, während die #ofLocale(Locale) Methode das Nachschlagen nach Gebietsschemas zulässt.

Die Chronology Instanz stellt eine Reihe von Methoden zum Erstellen ChronoLocalDate von Instanzen bereit. Die Datumsklassen werden verwendet, um bestimmte Datumsangaben zu bearbeiten. <ul><li><><#dateNow(Clock) dateNow(clock)#dateNow() dateNow()li#date(Era, int, int, int) date(era, yearOfEra, month, day)<><>#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)><<>#date(TemporalAccessor) date(TemporalAccessor)><<#dateNow(ZoneId) dateNow(zone)>#date(int, int, int) date(yearProleptic, month, day)#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)/ul>

<h2 id="addcalendars">Adding New Calendars</h2> The set of available chronologies can be extended by applications. Das Hinzufügen eines neuen Kalendersystems erfordert das Schreiben einer Implementierung von Chronologyund ChronoLocalDateEra. Der Großteil der logik, die für das Kalendersystem spezifisch ist, wird in der ChronoLocalDate Implementierung verwendet. Die Chronology Implementierung fungiert als Factory.

Um die Entdeckung zusätzlicher Chronologien zu ermöglichen, wird die java.util.ServiceLoader ServiceLoader Verwendet. Dem Verzeichnis muss eine Datei mit dem Namen "java.time.chrono.Chronology" hinzugefügt META-INF/services werden, in dem die Implementierungsklassen aufgeführt sind. Weitere Informationen zum Laden von Diensten finden Sie im ServiceLoader. Für die Suche nach id oder calendarType werden die vom System bereitgestellten Kalender zuerst gefolgt von den von der Anwendung bereitgestellten Kalendern gefunden.

Jede Chronologie muss eine chronologische ID definieren, die innerhalb des Systems eindeutig ist. Wenn die Chronologie ein durch die CLDR-Spezifikation definiertes Kalendersystem darstellt, ist der Kalendertyp die Verkettung des CLDR-Typs und gegebenenfalls die CLDR-Variante.

Hinzugefügt in 1.8.

Java Dokumentation für java.time.chrono.Chronology.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.