Javaでの日付比較：包括的なガイド

Javaは日付を比較するいくつかの方法を提供しており、それぞれに長所と短所があります。このガイドでは、レガシーのjava.util.Dateクラスと、新規プロジェクトには強く推奨される最新のjava.time APIの両方に焦点を当て、最も一般的な方法を解説します。

目次

• before()とafter()の使用
• equals()の使用
• compareTo()の使用
• java.timeによる最新のDate/Time比較

before()とafter()の使用

java.util.Dateクラスの一部であるbefore()メソッドとafter()メソッドは、単純な比較を提供します。before(Date otherDate)は、現在の日付がotherDateより前の場合にtrueを返し、after(Date otherDate)は現在の日付が後の場合にtrueを返します。ただし、java.util.Dateには時間情報が含まれているため、比較に影響することに注意してください。

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class DateComparison {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
        Date date1 = formatter.parse("2023-10-26");
        Date date2 = formatter.parse("2024-01-15");

        System.out.println("date1 before date2: " + date1.before(date2)); // true
        System.out.println("date2 after date1: " + date2.after(date1)); // true
    }
}

equals()の使用

equals()メソッドは、2つのjava.util.Dateオブジェクト間の完全一致をチェックします。trueを返すには、日付と時間の両方のコンポーネントが一致する必要があります。1ミリ秒の違いでもfalseになります。

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class DateComparison {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        Date date1 = formatter.parse("2023-10-26 10:00:00");
        Date date2 = formatter.parse("2023-10-26 10:00:00");

        System.out.println("date1 equals date2: " + date1.equals(date2)); // true
    }
}

compareTo()の使用

compareTo(Date otherDate)メソッドは、より微妙な比較を提供します。以下の値を返します。

• 現在の日付がotherDateより前の場合、負の値。
• 日付が等しい場合、ゼロ。
• 現在の日付がotherDateより後の場合、正の値。

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class DateComparison {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
        Date date1 = formatter.parse("2023-10-26");
        Date date2 = formatter.parse("2024-01-15");

        System.out.println("date1 compareTo date2: " + date1.compareTo(date2)); // 負の値
        System.out.println("date2 compareTo date1: " + date2.compareTo(date1)); // 正の値
    }
}

java.timeによる最新のDate/Time比較

java.time API（Java 8以降）は、日付と時刻の処理において優れたアプローチを提供します。LocalDate、LocalDateTime、ZonedDateTimeなどのクラスは、より正確で明確な比較を提供します。また、java.util.Dateの欠点も回避します。

import java.time.LocalDate;
import java.time.LocalDateTime;

public class ModernDateComparison {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.of(2023, 10, 26);
        LocalDate date2 = LocalDate.of(2024, 1, 15);

        System.out.println("date1 is before date2: " + date1.isBefore(date2)); // true
        System.out.println("date1 is after date2: " + date1.isAfter(date2)); // false
        System.out.println("date1 equals date2: " + date1.equals(date2)); // false


        LocalDateTime dateTime1 = LocalDateTime.of(2023, 10, 26, 10, 0, 0);
        LocalDateTime dateTime2 = LocalDateTime.of(2023, 10, 26, 10, 0, 0);
        System.out.println("dateTime1 equals dateTime2: " + dateTime1.equals(dateTime2)); //true

    }
}

java.time APIのメソッド（isBefore()、isAfter()、equals()）は、明確で曖昧さの無い比較を提供し、コードの可読性と保守性を向上させます。