【Java入門】日付を比較する方法｜compareTo()とequals()の使い方を解説

Javaで日付（Date）同士を比較するには、compareTo()メソッドを使用します。このメソッドは、呼び出し元の日付オブジェクトと引数に渡した日付オブジェクトを比較し、その大小関係を整数値として返します。

public int compareTo(Date anotherDate)

引数anotherDateには、比較対象となる日付を指定します。戻り値の意味は以下の通りです。

• 0：引数の日付と等しい場合
• 0より小さい値：この日付が引数の日付より前の場合
• 0より大きい値：この日付が引数の日付より後の場合

compareTo()を使った比較例

実際に2つの日付を比較するサンプルコードを見てみましょう。

import java.util.*;
public class Demo {
    public static void main(String[] args) {
        // 2つの日付を作成
        Date date = new Date(19, 3, 25);
        Date date2 = new Date(19, 9, 12);
        // 3通りの比較を実行
        int comparison = date.compareTo(date2);
        int comparison2 = date2.compareTo(date);
        int comparison3 = date.compareTo(date);
        // 結果を出力
        System.out.println("Comparison Result:" + comparison);
        System.out.println("Comparison2 Result:" + comparison2);
        System.out.println("Comparison3 Result:" + comparison3);
    }
}

実行結果

Comparison Result:-1
Comparison2 Result:1
Comparison3 Result:0

date（3月25日）はdate2（9月12日）よりも前の日付なので-1、逆にdate2から見るとdateは後の日付なので1、同じ日付同士を比較した場合は0が返されます。このように、戻り値の符号を見ることで2つの日付の前後関係を簡単に判定できます。

equals()メソッドで日付が等しいか判定する

2つの日付が完全に一致しているかどうかを調べたい場合は、ミリ秒単位の差分をもとに判定するequals()メソッドが便利です。戻り値はboolean型で、等しければtrue、異なればfalseが返ります。

import java.util.*;
public class Demo {
    public static void main(String[] args) {
        // 同じ内容の日付を2つ作成
        Date date = new Date(70, 1, 10);
        Date date2 = new Date(70, 1, 10);
        // 等しいかどうかを判定
        boolean check = date.equals(date2);
        System.out.println("Dates are equal:" + check);
    }
}

実行結果

Dates are equal:true

両者とも同じ日時を表しているため、equals()の結果はtrueとなりました。

補足：新規コードではjava.timeパッケージの利用を推奨

なお、new Date(年, 月, 日)のようなコンストラクタは現在では非推奨（deprecated）となっています。Java 8以降では、java.timeパッケージのLocalDateクラスを使うのが一般的です。LocalDateにはisBefore()、isAfter()、isEqual()といった直感的な比較メソッドが用意されており、より安全で読みやすい日付処理を書くことができます。既存のコードではcompareTo()やequals()がそのまま使えますが、新しく開発する場合はjava.time APIの活用を検討しましょう。