IChronology インターフェイス

定義

[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

派生

Java.Time.Chrono.AbstractChronology

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable IComparable IDisposable

注釈

日付の整理と識別に使用されるカレンダー システム。

メインの日付と時刻の API は、ISO カレンダー システム上に構築されています。 時系列はバックグラウンドで動作し、カレンダー システムの一般的な概念を表します。 たとえば、日本語、明魚、タイ仏教などです。

他のほとんどのカレンダー システムは、年、月、日の共有概念に基づいて動作し、太陽の周りの地球のサイクルと地球の周りの月にリンクされています。 これらの共有概念は、 ChronoField によって定義され、任意の Chronology 実装で使用できます。

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

図に示すように、日付オブジェクトは異なるカレンダー システム内にありますが、異なる Chronology インスタンスで表されますが、どちらも ChronoFieldで同じ定数を使用してクエリを実行できます。 この影響の詳細については、 ChronoLocalDateを参照してください。 一般に、アドバイスは、ChronoLocalDateではなく、既知の ISO ベースのLocalDateを使用する方法です。

Chronology オブジェクトは通常、ChronoFieldを使用し、日付の年号、年号、月、日のモデルに基づいていますが、これは必須ではありません。 Chronologyインスタンスは、マヤなど、まったく異なる種類のカレンダー システムを表している場合があります。

実際には、 Chronology インスタンスはファクトリとしても機能します。 #of(String) メソッドを使用すると、インスタンスを識別子で検索できますが、#ofLocale(Locale) メソッドではロケールによる検索が可能です。

Chronology インスタンスには、ChronoLocalDate インスタンスを作成するための一連のメソッドが用意されています。 日付クラスは、特定の日付を操作するために使用されます。 <ul><li>#dateNow() dateNow()<li>#dateNow(Clock) dateNow(clock)<li>#dateNow(ZoneId) dateNow(zone)<li>#date(int, int, int) date(yearProleptic, month, day)<li>#date(Era, int, int, int) date(era, yearOfEra, month, day)<li>#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)<li>#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)<li>#date(TemporalAccessor) date(TemporalAccessor)</ul>

<h2 id="addcalendars">新しい予定表の追加</h2> 使用可能な一連の chronologies は、アプリケーションによって拡張できます。 新しいカレンダー システムを追加するには、 Chronology、 ChronoLocalDate 、 Eraの実装を記述する必要があります。 カレンダー システムに固有のロジックの大部分は、 ChronoLocalDate 実装に含まれます。 Chronology実装はファクトリとして機能します。

追加の時系列の検出を許可するために、 java.util.ServiceLoader ServiceLoader が使用されます。 実装クラスを一覧表示する "java.time.chrono.Chronology" という名前のファイルを META-INF/services ディレクトリに追加する必要があります。 サービスの読み込みの詳細については、ServiceLoader を参照してください。 id または calendarType による検索では、システムが提供するカレンダーが最初に見つかり、その後にアプリケーションによって提供されるカレンダーが見つかります。

各時系列では、システム内で一意の時系列 ID を定義する必要があります。 年表が CLDR 仕様で定義されたカレンダー・システムを表す場合、カレンダー・タイプは CLDR タイプの連結であり、該当する場合は CLDR バリアントです。

1.8 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。