広告

Java : IsoEra (西暦、紀元前) - API使用例

IsoEra (Java SE 21 & JDK 21) の使い方まとめです。
だいたいのメソッドを網羅済みです。
API仕様書のおともにどうぞ。


概要

ISO暦体系の紀元。

クラス構成

IsoEra は、ISO暦体系 (西暦、紀元前) を表す 列挙型 です。
また、Era インタフェースを実装しています。

final var locale = Locale.getDefault();
System.out.println(locale.toLanguageTag()); // ja-JP

{
    final var era = IsoEra.CE;
    System.out.println(era.getValue()); // 1

    final var name = era.getDisplayName(TextStyle.FULL, locale);
    System.out.println(name); // 西暦
}
{
    final var era = IsoEra.BCE;
    System.out.println(era.getValue()); // 0

    final var name = era.getDisplayName(TextStyle.FULL, locale);
    System.out.println(name); // 紀元前
}
final var date1 = LocalDate.of(2100, 12, 31);
System.out.println(date1); // 2100-12-31
System.out.println(date1.getEra()); // CE

final var date2 = LocalDate.of(-99, 1, 2);
System.out.println(date2); // -0099-01-02
System.out.println(date2.getEra()); // BCE

列挙型定数

BCE

現在の紀元の前の紀元「紀元前」のシングルトン・インスタンスで、数値は0です。

final var era = IsoEra.BCE;
System.out.println(era.name()); // BCE
System.out.println(era.getValue()); // 0

CE

現在の紀元「紀元後」のシングルトン・インスタンスで、数値は1です。

final var era = IsoEra.CE;
System.out.println(era.name()); // CE
System.out.println(era.getValue()); // 1

メソッド

int getValue ()

数値の紀元のint値を取得します。

final var era = IsoEra.CE;
System.out.println(era); // CE

System.out.println(era.getValue()); // 1
final var era = IsoEra.BCE;
System.out.println(era); // BCE

System.out.println(era.getValue()); // 0

static IsoEra of (int isoEra)

int値からIsoEraのインスタンスを取得します。

final var era1 = IsoEra.of(0);
System.out.println(era1); // BCE

final var era2 = IsoEra.of(1);
System.out.println(era2); // CE

static IsoEra valueOf (String name)

指定された名前を持つこのクラスのenum定数を返します。

final var era1 = IsoEra.valueOf("BCE");
System.out.println(era1); // BCE

final var era2 = IsoEra.valueOf("CE");
System.out.println(era2); // CE

static IsoEra[] values ()

この列挙クラスの定数を含む配列を宣言されている順序で 返します。

for (final var era : IsoEra.values()) {
    System.out.println(era);
}

// 結果
// ↓
//BCE
//CE

Enumで宣言されたメソッド

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Java API 使用例 : Enum」をご参照ください。

Eraで宣言されたメソッド

adjustInto, get, getDisplayName, getLong, isSupported, query, range

Java API 使用例 : Era」をご参照ください。


関連記事

ページの先頭へ