JavaのLocalDateとequalsメソッドを完全解説！初心者でもわかる日付の比較方法

1. java.timeパッケージとは？

1. java.timeパッケージとは？

java.timeパッケージは、Java 8から導入された新しい日付と時間のAPIです。従来のjava.util.DateやCalendarに代わるもので、コードの可読性や使いやすさが大きく向上しています。

このパッケージには、日付・時刻・期間・フォーマット・タイムゾーンなどを扱う多くのクラスが含まれており、日常的な処理がシンプルに書けるようになっています。

その中でも、日付だけを扱いたいときに使えるのがLocalDateクラスです。

2. LocalDateクラスとは？

2. LocalDateクラスとは？

LocalDateクラスは、「年月日」のみを扱うクラスです。たとえば、「2025年9月4日」のようなカレンダーの日付を扱う場面で使います。時刻情報（時・分・秒）は持ちません。

次のようにLocalDateのインスタンスを作成できます。

import java.time.LocalDate;

public class LocalDateExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now(); // 現在の日付
        LocalDate birthday = LocalDate.of(1990, 12, 15); // 任意の日付を指定
        System.out.println("今日の日付: " + today);
        System.out.println("誕生日: " + birthday);
    }
}

3. equalsメソッドで日付を比較する

3. equalsメソッドで日付を比較する

日付が同じかどうかを調べたいときは、equalsメソッドを使います。これは、2つのLocalDateオブジェクトが同じ年月日かを判定するためのメソッドです。

使い方は非常に簡単で、以下のように記述します。

import java.time.LocalDate;

public class EqualsExample {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.of(2025, 9, 4);
        LocalDate date2 = LocalDate.of(2025, 9, 4);
        LocalDate date3 = LocalDate.now();

        System.out.println("date1とdate2は同じ日付か？ " + date1.equals(date2));
        System.out.println("date1とdate3は同じ日付か？ " + date1.equals(date3));
    }
}

上記を実行すると、以下のような結果が得られます。

date1とdate2は同じ日付か？ true
date1とdate3は同じ日付か？ false

4. equalsの注意点とポイント

4. equalsの注意点とポイント

equalsメソッドは、単に値が等しいかどうかを確認するだけで、時刻やタイムゾーンは無視されます。

ポイント：

• LocalDate同士を比べないと常にfalseになる。
• nullとの比較には注意が必要。null.equals(何か)はNullPointerExceptionになる。
• equalsは「==」とは違い、オブジェクトの内容を比較する。

次のようなコードはエラーになります。

LocalDate date = null;
if (date.equals(LocalDate.now())) { // NullPointerExceptionの原因！
    System.out.println("日付が一致しています");
}

これを避けるには、次のように書くと安全です。

if (LocalDate.now().equals(date)) {
    System.out.println("安全な比較です");
}

5. equalsメソッドと他の比較との違い

5. equalsメソッドと他の比較との違い

equalsメソッドは「完全一致」を調べるのに対し、日付の前後を比較したい場合はisBeforeやisAfterメソッドを使います。

LocalDate date1 = LocalDate.of(2025, 9, 4);
LocalDate date2 = LocalDate.of(2025, 9, 10);

System.out.println(date1.isBefore(date2)); // true
System.out.println(date1.isAfter(date2));  // false

equalsは「等しいか」、isBeforeとisAfterは「前か後か」を判定するためのメソッドという違いがあります。

6. equalsはオブジェクト比較の基本

6. equalsはオブジェクト比較の基本

equalsメソッドは、Javaのオブジェクト比較の基本です。日付だけでなく、文字列や自作クラスなどの比較でも重要な役割を果たします。

たとえば、Stringクラスもequalsメソッドを持っており、同じ文字列かどうかを比較できます。

Java初心者は、equalsの考え方に慣れておくと、今後のプログラミングがとても楽になります。

まとめ

まとめ

この記事では、Javaにおける日付処理の中でも特に重要なLocalDateクラスとequalsメソッドについて詳しく学んできました。Javaで日付を扱う場面は、業務システムやWebアプリケーション、バッチ処理、予約管理、スケジュール管理など非常に多く、正しい日付比較の理解は欠かせません。その中で、java.timeパッケージが登場したことで、従来のDateやCalendarに比べて、直感的で安全な日付操作が可能になりました。

LocalDateは「年月日」のみを扱うクラスであり、時刻やタイムゾーンの影響を受けないという特徴があります。この性質により、「同じ日かどうか」を正確に比較したい場面では非常に適しています。equalsメソッドを使えば、二つのLocalDateオブジェクトが完全に同じ日付かどうかを簡単に判定できます。これはJava初心者にとっても理解しやすく、実務でも頻繁に利用される基本的な書き方です。

また、equalsメソッドと「==」演算子の違いについて理解することも重要でした。「==」は参照が同じかどうかを比較するのに対し、equalsはオブジェクトの中身、つまり値が同じかどうかを比較します。この違いを理解していないと、日付が同じなのにfalseになる、といったバグにつながります。特にLocalDateの比較では、必ずequalsを使うという意識を持つことが大切です。

さらに、nullとの比較に関する注意点も学びました。nullに対してequalsを呼び出すと例外が発生するため、安全な書き方を身につける必要があります。こうした基本的な注意点を押さえておくことで、Javaのプログラムはより堅牢で読みやすいものになります。

日付の一致を確認する場合はequals、日付の前後関係を調べたい場合はisBeforeやisAfterを使う、という役割分担も理解できました。Javaの日付比較は一見難しそうに見えますが、目的に合ったメソッドを選ぶことで、コードは驚くほどシンプルになります。

以下は、これまで学んだ内容を意識したサンプルプログラムです。記事内と同じclass構成で、日付比較の基本を振り返ります。

import java.time.LocalDate;

public class LocalDateSummarySample {
    public static void main(String[] args) {
        LocalDate startDate = LocalDate.of(2025, 9, 4);
        LocalDate endDate = LocalDate.of(2025, 9, 4);

        if (startDate.equals(endDate)) {
            System.out.println("開始日と終了日は同じ日付です");
        } else {
            System.out.println("開始日と終了日は異なる日付です");
        }

        LocalDate today = LocalDate.now();
        if (today.isAfter(startDate)) {
            System.out.println("今日の日付は開始日より後です");
        }
    }
}