Javaの日付・時刻フィールドとは？TemporalFieldとChronoFieldの基本を解説

日付・時刻フィールド（Temporal Field）とは

日付・時刻フィールド（temporal field）とは、「月の何日」「年の何日目」のように、日付や時刻を構成する個々の要素を表す単位のことです。Javaでは、このようなフィールドは java.time.temporal.TemporalField インターフェースとして抽象化されており、標準的なフィールド一式は java.time.temporal.ChronoField 列挙型が実装しています。

ChronoField には日付関連のフィールドだけでなく、時刻関連のフィールド（HOUR_OF_DAY、MINUTE_OF_HOUR、SECOND_OF_MINUTE など）も多数用意されています。ここでは、まず日付に関連する主なフィールドを確認しましょう。

ChronoField の主な日付フィールド

get() / getLong() メソッドによる値の取得

LocalDate や LocalDateTime などの日付・時刻クラスが持つ get() / getLong() メソッドは、引数として TemporalField を受け取り、そのオブジェクトが保持する日付・時刻から指定フィールドの値を取り出します。

• get()：戻り値が int 型。ほとんどのフィールドはこちらで取得できます。
• getLong()：戻り値が long 型。EPOCH_DAY のように int の範囲を超える可能性があるフィールドに使用します。

サンプルコード1：LocalDate から日付フィールドを取得する

import java.time.LocalDate;
import java.time.temporal.ChronoField;

public class Demo {
    public static void main(String args[]) {
        // LocalDateクラスのインスタンスを生成
        LocalDate lDate = LocalDate.now();

        int field = lDate.get(ChronoField.DAY_OF_MONTH);
        System.out.println("月の日: " + field);

        field = lDate.get(ChronoField.DAY_OF_WEEK);
        System.out.println("曜日: " + field);

        field = lDate.get(ChronoField.DAY_OF_YEAR);
        System.out.println("年の通算日: " + field);

        long epoch = lDate.getLong(ChronoField.EPOCH_DAY);
        System.out.println("エポック日: " + epoch);

        field = lDate.get(ChronoField.ALIGNED_DAY_OF_WEEK_IN_MONTH);
        System.out.println("月内の整列曜日: " + field);

        field = lDate.get(ChronoField.ALIGNED_DAY_OF_WEEK_IN_YEAR);
        System.out.println("年内の整列曜日: " + field);

        field = lDate.get(ChronoField.ERA);
        System.out.println("紀元: " + field);
    }
}

実行結果

月の日: 11
曜日: 3
年の通算日: 316
エポック日: 18577
月内の整列曜日: 4
年内の整列曜日: 1
紀元: 1

この実行結果から、対象の日付が「月の11日目・火曜日（3）・年の316日目」であり、ERA の値が 1 であることから西暦（CE）であることがわかります。

サンプルコード2：Year・Month・DayOfWeek からフィールドを取得する

import java.time.DayOfWeek;
import java.time.LocalTime;
import java.time.Month;
import java.time.Year;
import java.time.temporal.ChronoField;

public class Demo {
    public static void main(String args[]) {
        // LocalTimeクラスのインスタンスを生成
        LocalTime lTime = LocalTime.now();
        System.out.println(lTime);

        int field = Year.of(2019).get(ChronoField.YEAR);
        System.out.println("年: " + field);

        field = Month.of(8).get(ChronoField.MONTH_OF_YEAR);
        System.out.println("月: " + field);

        field = DayOfWeek.of(3).get(ChronoField.DAY_OF_WEEK);
        System.out.println("曜日: " + field);
    }
}

実行結果

20:01:43.171
年: 2019
月: 8
曜日: 3

Year.of(2019)、Month.of(8)、DayOfWeek.of(3) のように生成したオブジェクトに対しても、同様に get() メソッドを使って対応するフィールドの値を取得できます。

まとめ

• 日付・時刻フィールドは TemporalField インターフェースで表現され、ChronoField が標準的な定義を提供します。
• LocalDate や LocalDateTime の get() / getLong() にフィールドを渡すだけで、個々の値を簡単に取り出せます。
• EPOCH_DAY のように大きな値になるフィールドは getLong() を使用しましょう。