JavaのLocalDateTime.equalsメソッドを徹底解説！初心者でもわかる日時の等価比較

1. java.timeパッケージについて

「1. java.timeパッケージについて」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. java.timeパッケージについて

java.timeパッケージはJava8から追加された新しい日付と時刻のAPIです。従来のDateやCalendarよりも直感的で、安全に日時を扱うことができます。タイムゾーンの管理や日時の比較、フォーマット変換など、多くの便利な機能がそろっています。

2. LocalDateTimeクラスの基本

2. LocalDateTimeクラスの基本

LocalDateTimeクラスは日付と時刻を表すためのクラスで、タイムゾーン情報を含まないのが特徴です。たとえば「2025年9月23日 10時30分」という日時をそのまま保持できます。スケジュール管理や予約システムなど、アプリケーション開発でよく使われます。

3. equalsメソッドの役割

3. equalsメソッドの役割

equalsメソッドは二つのLocalDateTimeオブジェクトが「完全に同じ日時かどうか」を判定します。日付だけでなく、時刻の分や秒まで一致していないとtrueにはなりません。結果は真偽値で返され、条件分岐に利用できます。

import java.time.LocalDateTime;

public class EqualsExample {
    public static void main(String[] args) {
        LocalDateTime dateTime1 = LocalDateTime.of(2025, 9, 23, 10, 0);
        LocalDateTime dateTime2 = LocalDateTime.of(2025, 9, 23, 10, 0);
        LocalDateTime dateTime3 = LocalDateTime.of(2025, 9, 23, 12, 0);

        System.out.println(dateTime1.equals(dateTime2)); // true
        System.out.println(dateTime1.equals(dateTime3)); // false
    }
}

true
false

4. equalsの利用シーン

「4. equalsの利用シーン」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. equalsの利用シーン

例えば「ある予約が特定の日時と一致するかどうかを確認する」といったシーンでequalsは役立ちます。シンプルな比較なので、プログラムの可読性も高まります。スケジュール管理アプリやログ解析などでよく利用されます。

5. compareToとの違い

5. compareToとの違い

compareToは日時の前後関係を調べるのに使われますが、equalsは「完全に同じかどうか」だけを判定します。そのため、「未来か過去か」を知りたいときはcompareTo、「完全に一致しているか」を知りたいときはequalsを使うのが適切です。

6. equalsとnullの扱い

6. equalsとnullの扱い

equalsメソッドは呼び出し元がnullの場合には使えません。そのため、比較する前にnullチェックを行うことが重要です。そうしないとNullPointerExceptionが発生してプログラムが停止してしまいます。

7. equalsと業務システムでの応用

「7. equalsと業務システムでの応用」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. equalsと業務システムでの応用

業務システムでは「支払期限が指定の日時と完全に一致するか」「イベントの開始時刻が予定通りか」など、日時の厳密な一致を判定する場面があります。こうした場面ではequalsがシンプルでわかりやすい手段となります。

8. equalsを利用した条件分岐例

8. equalsを利用した条件分岐例

最後に、指定した日時と現在時刻を比較して「一致しているかどうか」を確認するサンプルコードを紹介します。

import java.time.LocalDateTime;

public class NowEqualsExample {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        LocalDateTime check = LocalDateTime.of(now.getYear(), now.getMonth(), now.getDayOfMonth(), now.getHour(), now.getMinute());

        if (now.equals(check)) {
            System.out.println("現在の日時と完全に一致しました。");
        } else {
            System.out.println("一致していません。");
        }
    }
}

現在の日時と完全に一致しました。