Javaの日付・時刻における時間フィールド（TemporalField）とは？ChronoFieldの使い方を解説

テンポラルフィールド（時間フィールド）とは

テンポラルフィールド（temporal field）とは、「月の中の日」や「時」など、日付や時刻を構成する個々の項目（フィールド）のことです。Javaでは、これらのフィールドはTemporalFieldインターフェースとして表現され、標準的なフィールド定義はjava.time.temporal.ChronoFieldクラス（enum）によって提供されています。

LocalDateTimeクラスのget()メソッドおよびgetLong()メソッドは、引数としてテンポラルフィールドを受け取り、現在のオブジェクトが保持するそのフィールドの値を取得できます。値がint型の範囲に収まる場合はget()を、収まらない可能性がある場合はgetLong()を使用します。

主なChronoFieldの定数

日付関連のフィールドを取得する例

次の例では、現在日時から日付に関連するテンポラルフィールドの値を取得しています。

import java.time.LocalDateTime;
import java.time.temporal.ChronoField;

public class Demo {
    public static void main(String args[]) {
        // LocalDateTimeクラスのインスタンスを生成
        LocalDateTime lDate = LocalDateTime.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);
    }
}

実行結果

月の中の日: 25
曜日: 5
年の中の日: 237
エポック日: 17403
月内の整列曜日: 4
年内の整列曜日: 6
紀元: 1

時刻関連のフィールドを取得する例

次の例では、時刻に関連するテンポラルフィールドの値を取得しています。

import java.time.LocalDateTime;
import java.time.temporal.ChronoField;

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

        int field = lDateTime.get(ChronoField.CLOCK_HOUR_OF_AMPM);
        System.out.println("午前・午後単位の時: " + field);

        field = lDateTime.get(ChronoField.AMPM_OF_DAY);
        System.out.println("AM/PM: " + field);

        field = lDateTime.get(ChronoField.CLOCK_HOUR_OF_DAY);
        System.out.println("時: " + field);

        long minuteOfDay = lDateTime.getLong(ChronoField.MINUTE_OF_DAY);
        System.out.println("日の経過分: " + minuteOfDay);

        field = lDateTime.get(ChronoField.MINUTE_OF_HOUR);
        System.out.println("分: " + field);

        field = lDateTime.get(ChronoField.SECOND_OF_DAY);
        System.out.println("日の経過秒: " + field);

        field = lDateTime.get(ChronoField.SECOND_OF_MINUTE);
        System.out.println("秒: " + field);
    }
}

実行結果

2020-11-11T14:58:22.680
午前・午後単位の時: 2
AM/PM: 1
時: 14
日の経過分: 898
分: 58
日の経過秒: 53902
秒: 22

このように、ChronoFieldの各定数をget()／getLong()に渡すだけで、日付・時刻の任意の構成要素を簡単に取り出せます。なお、実行結果はプログラムを実行したタイミングによって異なる点に注意してください。