JavaのLocalDateとisBeforeメソッドの使い方を完全ガイド！初心者でもわかる日付の比較

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

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

Javaのjava.timeパッケージは、Java SE 8から導入された最新の日付と時刻のAPIです。従来のjava.util.DateやCalendarと比べて、はるかに扱いやすく、コードの可読性も高まります。このパッケージにはLocalDate、LocalTime、LocalDateTimeなどのクラスが含まれ、用途に応じた柔軟な日付操作が可能です。

2. LocalDateクラスとは？

2. LocalDateクラスとは？

LocalDateクラスは、年・月・日だけを表すシンプルな日付クラスです。時間やタイムゾーンの情報は含まれていません。たとえば、2025年9月1日といった日付だけを扱うときに最適です。

現在の日付を取得するには、以下のように記述します。

import java.time.LocalDate;

public class TodayExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今日の日付：" + today);
    }
}

3. isBeforeメソッドとは？

3. isBeforeメソッドとは？

isBeforeメソッドは、ある日付が指定された日付よりも「前」かどうかを判定するためのメソッドです。boolean型の値を返し、前であればtrue、そうでなければfalseになります。

構文は以下のようになります。

boolean result = date1.isBefore(date2);

この式は「date1がdate2よりも前ならtrue」という意味になります。

4. isBeforeメソッドの使い方

4. isBeforeメソッドの使い方

たとえば、今日が2025年12月31日よりも前かどうかを調べる場合、次のようなコードになります。

import java.time.LocalDate;

public class IsBeforeExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate targetDate = LocalDate.of(2025, 12, 31);

        if (today.isBefore(targetDate)) {
            System.out.println("今日の日付は2025年12月31日より前です。");
        } else {
            System.out.println("今日の日付は2025年12月31日以降です。");
        }
    }
}

今日の日付は2025年12月31日より前です。

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

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

LocalDateには他にも日付を比較するメソッドが用意されています。たとえば、isAfterは指定日より後かどうか、isEqualは同じ日付かどうかをチェックします。

• isAfter()：指定日より後か判定
• isEqual()：日付が等しいか判定
• compareTo()：日付の大小を数値で返す（ソート向き）

これらを組み合わせることで、細かい日付の条件分岐が可能になります。

6. 実務での活用シーン

6. 実務での活用シーン

isBeforeメソッドは、業務システムや日付チェックロジックで頻繁に使用されます。例えば「締め切り前かどうか」「キャンペーンの開始日より前か」などを判定するのに非常に役立ちます。

次の例では、ユーザーが入力した日付が過去かどうかを判定しています。

import java.time.LocalDate;

public class CheckPastDate {
    public static void main(String[] args) {
        LocalDate inputDate = LocalDate.of(2024, 12, 31);
        LocalDate today = LocalDate.now();

        if (inputDate.isBefore(today)) {
            System.out.println("入力された日付は過去の日付です。");
        } else {
            System.out.println("入力された日付は今日以降です。");
        }
    }
}

7. 日付を文字列で扱うときの注意点

7. 日付を文字列で扱うときの注意点

LocalDateは文字列から簡単に変換することができます。parseメソッドを使えば、「yyyy-MM-dd」の形式の文字列をLocalDate型に変換できます。

LocalDate date = LocalDate.parse("2025-09-04");

逆に、LocalDateを文字列に戻したい場合はtoString()を使います。

String str = date.toString(); // "2025-09-04"

8. LocalDateとnullチェック

8. LocalDateとnullチェック

LocalDateの比較メソッドを使う前に、対象のオブジェクトがnullでないことを必ず確認してください。nullのままisBeforeを実行するとNullPointerExceptionが発生してプログラムがクラッシュします。

たとえば以下のように事前にnullチェックを行いましょう。

if (inputDate != null && inputDate.isBefore(LocalDate.now())) {
    System.out.println("過去の日付が入力されました。");
}

9. 日付の範囲チェックに使うテクニック

9. 日付の範囲チェックに使うテクニック

ある日付が特定の期間内にあるかどうかを調べたい場合、isBeforeとisAfterを組み合わせて使うことが多いです。

たとえば「2025年1月1日から2025年12月31日までの間かどうか」をチェックするには次のように書きます。

LocalDate target = LocalDate.of(2025, 6, 1);
LocalDate start = LocalDate.of(2025, 1, 1);
LocalDate end = LocalDate.of(2025, 12, 31);

if ((target.isAfter(start) || target.isEqual(start)) && (target.isBefore(end) || target.isEqual(end))) {
    System.out.println("対象の日付は期間内です。");
}

まとめ

まとめ

LocalDateとisBeforeメソッドのポイント振り返り

ここまで、Javaにおける日付操作の基本として、java.timeパッケージの中核となるLocalDateクラスと、 日付を比較するためのisBeforeメソッドについて詳しく見てきました。 LocalDateは「年・月・日」だけを扱うシンプルな日付クラスであり、 時刻やタイムゾーンを含まないため、業務アプリケーションや学習用途でも非常に扱いやすい特徴があります。 従来のDateクラスやCalendarクラスに比べて、コードが直感的で読みやすく、 初心者でも日付処理の流れを理解しやすい点が大きなメリットです。

特にisBeforeメソッドは、「ある日付が別の日付より前かどうか」を真偽値で判定できるため、 条件分岐と非常に相性が良いメソッドです。 締め切り判定、過去日チェック、キャンペーン期間の確認など、 実務でも頻繁に登場するロジックを、無理なく安全に実装できます。 また、isAfterやisEqualと組み合わせることで、 日付の範囲チェックや境界条件の判定も明確に表現できるようになります。

実装時に意識したい注意点

日付比較を行う際に忘れてはいけないのがnullチェックです。 LocalDateはオブジェクトであるため、 値が設定されていない状態でisBeforeを呼び出すと例外が発生します。 実務ではユーザー入力や外部データを扱う場面が多いため、 必ず事前にnullかどうかを確認する習慣を身につけましょう。 この一手間が、プログラムの安定性と信頼性を大きく高めます。

まとめとしてのサンプルプログラム

最後に、これまで学んだ内容を整理するためのシンプルなサンプルプログラムを確認します。 今日の日付が指定した基準日より前かどうかを判定し、 安全に条件分岐を行う基本的な例です。

import java.time.LocalDate;

public class SummaryDateCheck {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate baseDate = LocalDate.of(2025, 12, 31);

        if (today != null && today.isBefore(baseDate)) {
            System.out.println("今日の日付は基準日より前です。");
        } else {
            System.out.println("今日の日付は基準日以降です。");
        }
    }
}

このように、LocalDateとisBeforeを使えば、 日付比較のロジックを簡潔かつ明確に記述できます。 初心者のうちは「日付の比較は難しそう」と感じがちですが、 基本的なメソッドの役割を理解すれば、決して複雑なものではありません。 むしろ、正しいクラスとメソッドを選ぶことで、 プログラム全体の見通しが良くなり、保守性も向上します。