IChronology Interface

Définition

[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

Dérivé

Java.Time.Chrono.AbstractChronology

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IComparable IDisposable

Remarques

Système de calendrier, utilisé pour organiser et identifier les dates.

L’API de date et d’heure principale est basée sur le système de calendrier ISO. La chronologie opère en arrière-plan pour représenter le concept général d’un système de calendrier. Par exemple, les japonais, Minguo, bouddhiste thaïlandais et d’autres.

La plupart des autres systèmes de calendrier fonctionnent également sur les concepts partagés de l’année, du mois et du jour, liés aux cycles de la Terre autour du Soleil et de la Lune autour de la Terre. Ces concepts partagés sont définis par ChronoField et sont disponibles pour une utilisation par n’importe quelle Chronology implémentation :

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

Comme indiqué, bien que les objets de date se trouvent dans différents systèmes de calendrier, représentés par différentes Chronology instances, les deux peuvent être interrogés à l’aide de la même constante sur ChronoField. Pour une discussion complète sur les implications de ce problème, consultez ChronoLocalDate. En général, les conseils sont d’utiliser les normes ISO LocalDateconnues plutôt que ChronoLocalDate.

Bien qu’un Chronology objet utilise ChronoField généralement et est basé sur une ère, un modèle de mois d’année, de mois d’année, de jour de mois d’une date, ce n’est pas nécessaire. Une Chronology instance peut représenter un type totalement différent de système de calendrier, tel que le Maya.

En pratique, l’instance Chronology agit également en tant qu’usine. La #of(String) méthode permet à une instance d’être recherchée par identificateur, tandis que la méthode autorise la #ofLocale(Locale) recherche par paramètres régionaux.

L’instance Chronology fournit un ensemble de méthodes pour créer ChronoLocalDate des instances. Les classes de date sont utilisées pour manipuler des dates spécifiques. <ul><li>#dateNow() dateNow()<>#dateNow(Clock) dateNow(clock)<>#dateNow(ZoneId) dateNow(zone)<>#date(int, int, int) date(yearProleptic, month, day)<>#date(Era, int, int, int) date(era, yearOfEra, month, day)<>#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)<li>#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)</ul>#date(TemporalAccessor) date(TemporalAccessor)<>

<h2 id="addcalendars">Ajout de nouveaux calendriers</h2> L’ensemble de chronologies disponibles peut être étendu par les applications. L’ajout d’un nouveau système de calendrier nécessite l’écriture d’une implémentation de Chronology, ChronoLocalDate et Era. La majorité de la logique spécifique au système de calendrier sera dans l’implémentation ChronoLocalDate . L’implémentation Chronology agit comme une fabrique.

Pour permettre la découverte de chronologies supplémentaires, elle java.util.ServiceLoader ServiceLoader est utilisée. Un fichier doit être ajouté au META-INF/services répertoire portant le nom « java.time.chrono.Chronology » répertoriant les classes d’implémentation. Pour plus d’informations sur le chargement de service, consultez le ServiceLoader. Pour la recherche par ID ou calendarType, les calendriers fournis par le système sont trouvés en premier suivi des calendriers fournis par l’application.

Chaque chronologie doit définir un ID de chronologie unique au sein du système. Si la chronologie représente un système de calendrier défini par la spécification CLDR, le type de calendrier est la concaténation du type CLDR et, le cas échéant, la variante CLDR.

Ajouté dans la version 1.8.

Java documentation pour java.time.chrono.Chronology.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.