- java.lang.Object
-
- java.time.chrono.JapaneseEra
-
- すべての実装されたインタフェース:
Serializable
,Era
,TemporalAccessor
,TemporalAdjuster
public final class JapaneseEra extends Object implements Era, Serializable
和暦体系の紀元。このクラスは和暦の有効な紀元を定義します。 日本では明治6年からグレゴリオ暦を導入しています。 明治以降の紀元のみサポートされ、明治6年1月1日より前の日付はサポートされません。
- 実装要件:
- このクラスは不変でスレッドセーフです。
- 導入されたバージョン:
- 1.8
- 関連項目:
- 直列化された形式
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static JapaneseEra
HEISEI
値2を持つ「平成」時代(1989-01-08 - 現在)のシングルトン・インスタンス。static JapaneseEra
MEIJI
値-1を持つ「明治」時代(1868-01-01 - 1912-07-29)のシングルトン・インスタンス。static JapaneseEra
SHOWA
値1を持つ「昭和」時代(1926-12-25 - 1989-01-07)のシングルトン・インスタンス。static JapaneseEra
TAISHO
値0を持つ「大正」時代(1912-07-30 - 1926-12-24)のシングルトン・インスタンス。
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 String
getDisplayName(TextStyle style, Locale locale)
この紀元のテキスト表現を取得します。int
getValue()
数値の紀元のint
値を取得します。static JapaneseEra
of(int japaneseEra)
int
値からJapaneseEra
のインスタンスを取得します。ValueRange
range(TemporalField field)
指定されたフィールドの有効な値の範囲を取得します。String
toString()
オブジェクトの文字列表現を返します。static JapaneseEra
valueOf(String japaneseEra)
その名前を持つJapaneseEra
を返します。static JapaneseEra[]
values()
JapaneseErasの配列を返します。-
インタフェースjava.time.chrono.Eraから継承されたメソッド
adjustInto, get, getLong, isSupported, query
-
-
-
-
フィールドの詳細
-
MEIJI
public static final JapaneseEra MEIJI
値-1を持つ「明治」時代(1868-01-01 - 1912-07-29)のシングルトン・インスタンス。
-
TAISHO
public static final JapaneseEra TAISHO
値0を持つ「大正」時代(1912-07-30 - 1926-12-24)のシングルトン・インスタンス。
-
SHOWA
public static final JapaneseEra SHOWA
値1を持つ「昭和」時代(1926-12-25 - 1989-01-07)のシングルトン・インスタンス。
-
HEISEI
public static final JapaneseEra HEISEI
値2を持つ「平成」時代(1989-01-08 - 現在)のシングルトン・インスタンス。
-
-
メソッドの詳細
-
of
public static JapaneseEra of(int japaneseEra)
int
値からJapaneseEra
のインスタンスを取得します。1970-01-01 (ISO暦体系)を含む
SHOWA
紀元の値は1で、後の紀元は2 (HEISEI
)と番号付けされています。 以前の紀元は 0 (TAISHO
)、-1 (MEIJI
)と番号付けされ、明治以降の紀元のみがサポートされています。- パラメータ:
japaneseEra
- 表す紀元- 戻り値:
JapaneseEra
シングルトン、null以外- 例外:
DateTimeException
- 値が無効な場合
-
valueOf
public static JapaneseEra valueOf(String japaneseEra)
その名前を持つJapaneseEra
を返します。文字列は、紀元の名前と完全に一致している必要があります。 (不適切な空白文字は許可されません。)
- パラメータ:
japaneseEra
- japaneseEra名、null以外- 戻り値:
JapaneseEra
シングルトン、nullにはならない- 例外:
IllegalArgumentException
- 指定された名前を持つJapaneseEraがない場合
-
values
public static JapaneseEra[] values()
JapaneseErasの配列を返します。このメソッドは、次のようにしてJapaneseEraに対して反復処理を行うために使用できます。
for (JapaneseEra c : JapaneseEra.values()) System.out.println(c);
- 戻り値:
- JapaneseErasの配列
-
getDisplayName
public String getDisplayName(TextStyle style, Locale locale)
この紀元のテキスト表現を取得します。これは、紀元の識別に使用され、ユーザーへの表示に適したテキストの名前を返します。 パラメータは返されるテキストとロケールのスタイルを制御します。
テキスト・マッピングが見つからない場合、
数値
が返されます。- 定義:
- インタフェース
Era
内のgetDisplayName
- パラメータ:
style
- 必要なテキストのスタイル、null以外locale
- 使用するロケール。null以外- 戻り値:
- 紀元のテキスト値、null以外
-
getValue
public int getValue()
-
range
public ValueRange range(TemporalField field)
指定されたフィールドの有効な値の範囲を取得します。範囲オブジェクトはフィールドの有効な最小値と最大値を表します。 この紀元は、返される範囲の精度を向上するために使われます。 範囲を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
フィールドが
ChronoField
の場合、ここに問合せを実装します。ERA
フィールドは範囲を返します。 他のすべてのChronoField
インスタンスはUnsupportedTemporalTypeException
をスローします。フィールドが
ChronoField
ではない場合、このメソッドの結果は、引数としてthis
を渡してTemporalField.rangeRefinedBy(TemporalAccessor)
を呼び出すことにより取得されます。 範囲を取得できるかどうかはフィールドによって決まります。有効な和暦の紀元の範囲は、和暦体系の性質のため、時間の経過とともに変更される可能性があります。
- 定義:
- インタフェース
Era
のrange
- 定義:
- インタフェース
TemporalAccessor
のrange
- パラメータ:
field
- 範囲を問い合わせるフィールド、null以外- 戻り値:
- フィールドの有効値の範囲。null以外
- 例外:
DateTimeException
- フィールドの範囲を取得できない場合UnsupportedTemporalTypeException
- 単位がサポートされていない場合
-
toString
public String toString()
次のクラスからコピーされた説明:Object
オブジェクトの文字列表現を返します。 一般に、toString
メソッドは、このオブジェクトを「テキストで表す」文字列を返します。 この結果は、人間が読める簡潔で有益な情報であるべきです。 すべてのサブクラスで、このメソッドをオーバーライドすることをお薦めします。クラス
Object
のtoString
メソッドは、オブジェクトがインスタンスになっている元のクラスの名前、アットマーク文字「@
」、およびオブジェクトのハッシュ・コードの符号なし16進数表現から構成される文字列を返します。 つまり、このメソッドは次の値と等しい文字列を返します。getClass().getName() + '@' + Integer.toHexString(hashCode())
-
-