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」をご参照ください。

API 使用例

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

概要

列挙型定数

BCE

CE

メソッド

int getValue ()

static IsoEra of (int isoEra)

static IsoEra valueOf (String name)

static IsoEra[] values ()

Enumで宣言されたメソッド

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

Eraで宣言されたメソッド

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

関連記事