java.lang.Object
- java.time.chrono.HijrahDate

すべての実装されたインタフェース:

Serializable, Comparable<ChronoLocalDate>, ChronoLocalDate, Temporal, TemporalAccessor, TemporalAdjuster
```
public final class HijrahDate
extends Object
implements ChronoLocalDate, Serializable
```
ヒジュラ暦体系の日付。
この日付はヒジュラ暦のいずれかのバリアントを使用して処理されます。
ヒジュラ暦は、グレゴリオ暦と1年の合計日が異なり、各月の長さは、月が地球の周りを一周する期間に基づきます(連続する新月の間として)。サポートされるバリアントについては、HijrahChronologyを参照してください。
各HijrahDateは特定のHijrahChronologyに結合されて作成されます。同じ暦が日付から計算された各HijrahDateに伝播されます。別のヒジュラ暦のバリアントを使用するには、そのHijrahChronologyを使用して、新しいHijrahDateインスタンスを作成することができます。または、withVariant(java.time.chrono.HijrahChronology)メソッドを使用して、新しいHijrahChronologyに変換できます。
これは値ベースのクラスです。HijrahDateのインスタンスに対する、IDに依存した操作(参照型等価(==)、IDハッシュ・コード、または同期を含む)の使用は、予測できない結果になる可能性があるため、避けてください。比較する場合は、equalsメソッドを使用することをお薦めします。

実装要件:

このクラスは不変でスレッドセーフです。

導入されたバージョン:

1.8

関連項目:

直列化された形式

メソッドのサマリー

すべてのメソッド静的メソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`boolean`	`equals(Object obj)`	暦を含めて、この日付を別の日付と比較します。
`static HijrahDate`	`from(TemporalAccessor temporal)`	時間的オブジェクトからイスラム・ウム・アルクラ暦の`HijrahDate`を取得します。
`HijrahChronology`	`getChronology()`	ヒジュラ暦体系であるこの日付の暦を取得します。
`HijrahEra`	`getEra()`	この日付で使用可能な紀元を取得します。
`int`	`hashCode()`	この日付のハッシュ・コード。
`boolean`	`isLeapYear()`	ヒジュラ暦体系のルールに従って、年がうるう年であるかどうかをチェックします。
`int`	`lengthOfMonth()`	この日付によって表される月の長さを返します。
`int`	`lengthOfYear()`	この日付によって表される年の長さを返します。
`HijrahDate`	`minus(TemporalAmount amount)`	量を減算して、このオブジェクトと同じ型のオブジェクトを返します。
`static HijrahDate`	`now()`	デフォルトのタイムゾーンのイスラム・ウム・アルクラ暦の現在の`HijrahDate`を取得します。
`static HijrahDate`	`now(Clock clock)`	指定されたクロックからイスラム・ウム・アルクラ暦の現在の`HijrahDate`を取得します。
`static HijrahDate`	`now(ZoneId zone)`	指定されたタイムゾーンのイスラム・ウム・アルクラ暦の現在の`HijrahDate`を取得します。
`static HijrahDate`	`of(int prolepticYear, int month, int dayOfMonth)`	先発暦の年、年の月、および「月の日」フィールドからイスラム・ウム・アルクラ暦の`HijrahDate`を取得します。
`HijrahDate`	`plus(TemporalAmount amount)`	ある時間を追加して、このオブジェクトと同じ型のオブジェクトを返します。
`String`	`toString()`	オブジェクトの文字列表現を返します。
`long`	`until(Temporal endExclusive, TemporalUnit unit)`	もう一方の日付までの時間量を指定された単位で計算します。
`HijrahDate`	`with(TemporalAdjuster adjuster)`	調整を行って、このオブジェクトと同じ型の調整済オブジェクトを返します。
`HijrahDate`	`withVariant(HijrahChronology chronology)`	リクエストされた暦を使って`HijrahDate`を返します。

クラス java.lang.Objectで宣言されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース java.time.chrono.ChronoLocalDateで宣言されたメソッド
adjustInto, atTime, compareTo, format, isAfter, isBefore, isEqual, isSupported, isSupported, minus, plus, query, toEpochDay, toString, until, until, with

インタフェース java.time.temporal.TemporalAccessorで宣言されたメソッド
get, getLong, range

- メソッドの詳細
  - now
```
public static HijrahDate now()
```
    デフォルトのタイムゾーンのイスラム・ウム・アルクラ暦の現在のHijrahDateを取得します。
    これは、デフォルトのタイムゾーンのsystem clockを問い合わせ、現在の日付を取得します。
    このメソッドを使用すると、クロックがハードコードされているため、テストに代替のクロックを使用できないようにします。
    
    戻り値:
    
    システムクロックとデフォルトのタイムゾーンを使用した現在の日付、null以外
  - now
```
public static HijrahDate now(ZoneId zone)
```
    指定されたタイムゾーンのイスラム・ウム・アルクラ暦の現在のHijrahDateを取得します。
    これはsystem clockを問い合わせて、現在の日付を取得します。タイムゾーンを指定すると、デフォルトのタイムゾーンへの依存を避けられます。
    このメソッドを使用すると、クロックがハードコードされているため、テストに代替のクロックを使用できないようにします。
    
    パラメータ:
    
    zone - 使用するゾーンID、null以外
    
    戻り値:
    
    システムクロックを使用した現在の日付、null以外
  - now
```
public static HijrahDate now(Clock clock)
```
    指定されたクロックからイスラム・ウム・アルクラ暦の現在のHijrahDateを取得します。
    これは指定されたクロックを問い合わせ、現在の日付(今日)を取得します。このメソッドを使用すると、テストに代替のクロックを使用できます。代替のクロックは依存性注入を使用して導入できます。
    
    パラメータ:
    
    clock - 使用するクロック、null以外
    
    戻り値:
    
    現在の日付、null以外
    
    例外:
    
    DateTimeException - 現在の日付を取得できない場合
  - of
```
public static HijrahDate of(int prolepticYear,
                            int month,
                            int dayOfMonth)
```
    先発暦の年、年の月、および「月の日」フィールドからイスラム・ウム・アルクラ暦のHijrahDateを取得します。
    これは、指定されたフィールドでHijrahDateを返します。日は年と月に対して有効である必要があり、そうでない場合は、例外がスローされます。
    
    パラメータ:
    
    prolepticYear - ヒジュラ暦の先発暦の年
    
    month - ヒジュラ暦の年の月、1-12
    
    dayOfMonth - ヒジュラ暦の「月の日」、1-30
    
    戻り値:
    
    ヒジュラ暦体系の日付、null以外
    
    例外:
    
    DateTimeException - いずれかのフィールドの値が範囲外である場合、または「月の日」が年の月に対して無効である場合
  - from
```
public static HijrahDate from(TemporalAccessor temporal)
```
    時間的オブジェクトからイスラム・ウム・アルクラ暦のHijrahDateを取得します。
    これは、指定された時間的オブジェクトに基づいてヒジュラ暦体系での日付を取得します。 TemporalAccessorは任意の日付と時間情報のセットを表し、このファクトリがHijrahDateのインスタンスに変換します。
    変換では一般に、暦体系全体で標準化されたEPOCH_DAYフィールドを使用します。
    このメソッドは関数型インタフェースTemporalQueryのシグネチャに一致するため、メソッド参照HijrahDate::fromを介して、問合せとして使用できます。
    
    パラメータ:
    
    temporal - 変換する一時オブジェクト、null以外
    
    戻り値:
    
    ヒジュラ暦体系の日付、null以外
    
    例外:
    
    DateTimeException - HijrahDateに変換できない場合
    
    関連項目:
    
    Chronology.date(TemporalAccessor)
  - getChronology
```
public HijrahChronology getChronology()
```
    ヒジュラ暦体系であるこの日付の暦を取得します。
    Chronologyは使用中の暦体系を表します。 ChronoFieldの紀元およびその他のフィールドは暦によって定義されます。
    
    定義:
    
    インタフェースChronoLocalDateのgetChronology
    
    戻り値:
    
    ヒジュラ暦、null以外
  - getEra
```
public HijrahEra getEra()
```
    この日付で使用可能な紀元を取得します。
    ヒジュラ暦体系には、HijrahEraによって定義される1つの紀元「AH」があります。
    
    定義:
    
    インタフェースChronoLocalDateのgetEra
    
    戻り値:
    
    この日付に該当する紀元、null以外
  - lengthOfMonth
```
public int lengthOfMonth()
```
    この日付によって表される月の長さを返します。
    これは月の長さを日数で返します。ヒジュラ暦体系の月の長さは29日から30日でさまざまに異なります。
    
    定義:
    
    インタフェースChronoLocalDateのlengthOfMonth
    
    戻り値:
    
    日数での月の長さ
  - lengthOfYear
```
public int lengthOfYear()
```
    この日付によって表される年の長さを返します。
    これは年の長さを日数で返します。ヒジュラ暦体系の年は、一般にISO暦体系より短くなります。
    
    定義:
    
    インタフェースChronoLocalDateのlengthOfYear
    
    戻り値:
    
    日数での年の長さ
  - with
```
public HijrahDate with(TemporalAdjuster adjuster)
```
    調整を行って、このオブジェクトと同じ型の調整済オブジェクトを返します。
    これは、指定されたアジャスタのルールに従って、この日付/時間を調整します。単純なアジャスタは、年フィールドなどの1つのフィールドだけを設定するなどです。複雑なアジャスタは、日付を月の最後の日に設定するなどです。一般的な調整の選択は、TemporalAdjustersで指定します。これらには、「月の最後の日」や「次の水曜日」を見つけることが含まれます。アジャスタは、さまざまな長さの月やうるう年などの特別なケースの処理を担当します。
    このメソッドを使用する方法と理由を示すいくつかのサンプル・コード:
    date = date.with(Month.JULY); // most key classes implement TemporalAdjuster date = date.with(lastDayOfMonth()); // static import from Adjusters date = date.with(next(WEDNESDAY)); // static import from Adjusters and DayOfWeek
    定義:
    
    インタフェースChronoLocalDateのwith
    
    定義:
    
    インタフェースTemporalのwith
    
    パラメータ:
    
    adjuster - 使用するアジャスタ、null以外
    
    戻り値:
    
    指定された調整を行った同じ型のオブジェクト、null以外
    
    例外:
    
    DateTimeException - 調整を実行できない場合。たとえば、アジャスタでISO暦が必要な場合
    
    ArithmeticException - 数値のオーバーフローが発生した場合
  - withVariant
```
public HijrahDate withVariant(HijrahChronology chronology)
```
    リクエストされた暦を使ってHijrahDateを返します。
    年、月、日は新しく要求されたHijrahChronologyに対してチェックされます。暦の月の長さが短い場合、月の最終日になるように日が減らされます。
    
    パラメータ:
    
    chronology - 新しいHijrahChonology、null以外
    
    戻り値:
    
    要求されたHijrahChronologyでのHijrahDate、null以外
  - plus
```
public HijrahDate plus(TemporalAmount amount)
```
    ある時間を追加して、このオブジェクトと同じ型のオブジェクトを返します。
    これは、このtemporal (一時)を調整し、指定された量のルールに従って加算します。この量は通常Periodですが、Durationなど、TemporalAmountインタフェースを実装する他のどの型であってもかまいません。
    このメソッドを使用する方法と理由を示すいくつかのサンプル・コード:
    date = date.plus(period); // add a Period instance date = date.plus(duration); // add a Duration instance date = date.plus(workingDays(6)); // example user-written workingDays method
    
    plusの後にminusを呼び出しても、同じ日付/時間が返されることは保証されません。
    定義:
    
    インタフェースChronoLocalDateのplus
    
    定義:
    
    インタフェースTemporalのplus
    
    パラメータ:
    
    amount - 追加する量、null以外
    
    戻り値:
    
    指定された調整を行った同じ型のオブジェクト、null以外
    
    例外:
    
    DateTimeException - 加算できない場合
    
    ArithmeticException - 数値のオーバーフローが発生した場合
  - minus
```
public HijrahDate minus(TemporalAmount amount)
```
    量を減算して、このオブジェクトと同じ型のオブジェクトを返します。
    これは、このtemporal (一時)を調整し、指定された量のルールに従って減算します。この量は通常Periodですが、Durationなど、TemporalAmountインタフェースを実装する他のどの型であってもかまいません。
    このメソッドを使用する方法と理由を示すいくつかのサンプル・コード:
    date = date.minus(period); // subtract a Period instance date = date.minus(duration); // subtract a Duration instance date = date.minus(workingDays(6)); // example user-written workingDays method
    
    plusの後にminusを呼び出しても、同じ日付/時間が返されることは保証されません。
    定義:
    
    インタフェースChronoLocalDateのminus
    
    定義:
    
    インタフェースTemporalのminus
    
    パラメータ:
    
    amount - 減算する量、null以外
    
    戻り値:
    
    指定された調整を行った同じ型のオブジェクト、null以外
    
    例外:
    
    DateTimeException - 減算ができない場合
    
    ArithmeticException - 数値のオーバーフローが発生した場合
  - isLeapYear
```
public boolean isLeapYear()
```
    ヒジュラ暦体系のルールに従って、年がうるう年であるかどうかをチェックします。
    
    定義:
    
    インタフェースChronoLocalDateのisLeapYear
    
    戻り値:
    
    この日付がうるう年にある場合はtrue
  - equals
```
public boolean equals(Object obj)
```
    暦を含めて、この日付を別の日付と比較します。
    このHijrahDateを別の日付と比較して、日付が同じであることを確認します。
    HijrahDate型のオブジェクトのみが比較され、それ以外の型はfalseを返します。 2つの異なる暦の日付など、2つのTemporalAccessorインスタンスの日付を比較するには、コンパレータとしてChronoField.EPOCH_DAYを使用します。
    
    定義:
    
    インタフェースChronoLocalDateのequals
    
    パラメータ:
    
    obj - チェックするオブジェクト、nullはfalseを返す
    
    戻り値:
    
    これが他の日付と等しく、暦が等しい場合はtrue
    
    関連項目:
    
    Object.hashCode()、HashMap
  - hashCode
```
public int hashCode()
```
    この日付のハッシュ・コード。
    
    定義:
    
    インタフェースChronoLocalDateのhashCode
    
    戻り値:
    
    暦と日付にのみ基づいた適切なハッシュ・コード
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - until
```
public long until(Temporal endExclusive,
                  TemporalUnit unit)
```
    次のインタフェースからコピーされた説明: ChronoLocalDate
    もう一方の日付までの時間量を指定された単位で計算します。
    これは、1つのTemporalUnitの形で2つのChronoLocalDateオブジェクト間の時間の量を計算します。開始点と終了点はthisと指定された日付です。終了が開始より前である場合、結果は負になります。このメソッドに渡されたTemporalはChronology.date(TemporalAccessor)を使用してChronoLocalDateに変換されます。計算では、2つの日付間の完全な単位の数を表す整数を返します。たとえば、2つの日付間の日数での量は、startDate.until(endDate, DAYS)を使用して計算できます。
    このメソッドを使用する等価な方法が2つあります。 1つ目はこのメソッドを呼び出すことです。 2つ目はTemporalUnit.between(Temporal, Temporal)を使用することです。
    // these two lines are equivalent amount = start.until(end, MONTHS); amount = MONTHS.between(start, end);
    この選択は、コードが読みやすくなるのはどちらかに基づいて行ってください。
    計算はChronoUnitのこのメソッドに実装します。単位DAYS、WEEKS、MONTHS、YEARS、DECADES、CENTURIES、MILLENNIA、およびERASはすべての実装でサポートしてください。その他のChronoUnit値は例外をスローします。
    単位がChronoUnitでない場合、このメソッドの結果は、thisを1つ目の引数として、変換される入力temporal (一時)を2つ目の引数として渡してTemporalUnit.between(Temporal, Temporal)を呼び出すことによって取得します。
    このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
    定義:
    
    インタフェースChronoLocalDateのuntil
    
    定義:
    
    インタフェースTemporalのuntil
    
    パラメータ:
    
    endExclusive - 終了日、排他的、同じ暦でChronoLocalDateに変換される、null以外
    
    unit - 量を測定する単位、null以外
    
    戻り値:
    
    この日付と終了日の間の時間の量
  - toString
```
public String toString()
```
    次のクラスからコピーされた説明: Object
    オブジェクトの文字列表現を返します。一般に、toStringメソッドは、このオブジェクトを「テキストで表す」文字列を返します。この結果は、人間が読める簡潔で有益な情報であるべきです。すべてのサブクラスで、このメソッドをオーバーライドすることをお勧めします。
    クラスObjectのtoStringメソッドは、オブジェクトがインスタンスになっている元のクラスの名前、アットマーク文字「@」、およびオブジェクトのハッシュ・コードの符号なし16進数表現から構成される文字列を返します。つまり、このメソッドは次の値と等しい文字列を返します。
    
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    定義:
    
    インタフェースChronoLocalDateのtoString
    
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    このオブジェクトの文字列表現

クラスHijrahDate

メソッドのサマリー

クラス java.lang.Objectで宣言されたメソッド

インタフェース java.time.chrono.ChronoLocalDateで宣言されたメソッド

インタフェース java.time.temporal.TemporalAccessorで宣言されたメソッド

メソッドの詳細

now

now

now

of

from

getChronology

getEra

lengthOfMonth

lengthOfYear

with

withVariant

plus

minus

isLeapYear

equals

hashCode

until

toString