JavaのChronoUnit.DAYSとbetweenメソッドの使い方を完全解説！日数計算を初心者向けにわかりやすく説明

1. ChronoUnit.DAYSとは？

「1. ChronoUnit.DAYSとは？」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. ChronoUnit.DAYSとは？

ChronoUnit.DAYSは、 Javaの日時APIであるjava.timeパッケージに含まれている機能です。 主に「日数差」を取得するときに利用されます。

Java初心者の方は、 日付計算を自分で実装しようとして複雑な処理を書いてしまうことがあります。 しかし、ChronoUnit.DAYSを利用すれば、 二つの日付の差を簡単に計算できます。

Javaの業務システムでは、 契約日数、 利用日数、 予約期間、 経過日数などを求める場面が非常に多くあります。

Javaの日付計算では、 古いDateクラスではなく、 LocalDateとChronoUnitを組み合わせる方法が推奨されています。

2. betweenメソッドとは？

2. betweenメソッドとは？

betweenメソッドは、 二つの日付や時間の差分を取得するためのメソッドです。

Javaで日付差分を求める場合、 非常によく利用される便利なメソッドです。

基本構文は次のようになります。

ChronoUnit.DAYS.between(開始日, 終了日);

このコードを実行すると、 開始日から終了日までの日数差を取得できます。

Javaでは、 日数だけではなく、 月数、 年数、 時間、 分なども取得可能です。

3. 日数差を取得する基本サンプル

3. 日数差を取得する基本サンプル

まずは、 Javaで二つの日付の日数差を取得する基本サンプルを見てみましょう。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class DaysExample {
    public static void main(String[] args) {

        LocalDate startDate = LocalDate.of(2025, 1, 1);
        LocalDate endDate = LocalDate.of(2025, 1, 15);

        long days = ChronoUnit.DAYS.between(startDate, endDate);

        System.out.println("日数差：" + days);
    }
}

このプログラムでは、 二つの日付を比較して日数差を取得しています。

LocalDateは、 年月日を扱うためのJavaクラスです。 時間情報を含まないため、 日付計算に最適です。

日数差：14

Javaの日時計算では、 この書き方が非常によく利用されています。

4. 現在の日付との差を取得する方法

「4. 現在の日付との差を取得する方法」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. 現在の日付との差を取得する方法

Javaでは、 現在の日付との差分を取得したい場面も多くあります。

例えば、 会員登録から何日経過したかを計算したい場合などに利用されます。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class ElapsedDaysExample {
    public static void main(String[] args) {

        LocalDate registerDate = LocalDate.of(2025, 4, 1);
        LocalDate today = LocalDate.now();

        long days = ChronoUnit.DAYS.between(registerDate, today);

        System.out.println("経過日数：" + days);
    }
}

LocalDate.now()を利用すると、 現在の日付を取得できます。

Javaの業務システムでは、 現在日付との差分計算は頻繁に利用されます。

経過日数：35

5. マイナス値になるケース

5. マイナス値になるケース

betweenメソッドでは、 開始日と終了日の順番に注意する必要があります。

開始日が終了日より未来の場合、 結果はマイナス値になります。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class MinusDaysExample {
    public static void main(String[] args) {

        LocalDate futureDate = LocalDate.of(2026, 1, 1);
        LocalDate today = LocalDate.now();

        long days = ChronoUnit.DAYS.between(futureDate, today);

        System.out.println("日数差：" + days);
    }
}

日数差：-240

Javaで日付計算をするときは、 開始日と終了日の順番を意識することが重要です。

6. DAYS以外にも利用できる単位

6. DAYS以外にも利用できる単位

ChronoUnitには、 DAYS以外にもさまざまな単位があります。

Javaの日時APIでは、 用途に応じて単位を使い分けることが重要です。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class MultipleUnitExample {
    public static void main(String[] args) {

        LocalDate startDate = LocalDate.of(2024, 1, 1);
        LocalDate endDate = LocalDate.of(2025, 5, 1);

        long years = ChronoUnit.YEARS.between(startDate, endDate);
        long months = ChronoUnit.MONTHS.between(startDate, endDate);
        long days = ChronoUnit.DAYS.between(startDate, endDate);

        System.out.println("年数差：" + years);
        System.out.println("月数差：" + months);
        System.out.println("日数差：" + days);
    }
}

年数差：1
月数差：16
日数差：486

Javaでは、 同じ日付でも取得する単位によって結果が変わります。

7. LocalDateと組み合わせる理由

「7. LocalDateと組み合わせる理由」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. LocalDateと組み合わせる理由

ChronoUnit.DAYSは、 主にLocalDateと組み合わせて利用されます。

LocalDateは、 Javaで日付のみを扱うためのクラスです。 時間情報を含まないため、 シンプルに日付計算できます。

Java初心者の方は、 古いDateクラスを使ってしまうことがありますが、 現在ではLocalDateを利用する方法が一般的です。

import java.time.LocalDate;

public class LocalDateNowExample {
    public static void main(String[] args) {

        LocalDate today = LocalDate.now();

        System.out.println(today);
    }
}

2026-05-06

Javaの日付操作では、 LocalDateとChronoUnitをセットで覚えると理解しやすくなります。

8. ChronoUnit.DAYSを使うときの注意点

8. ChronoUnit.DAYSを使うときの注意点

JavaでChronoUnit.DAYSを使う場合、 いくつか注意点があります。

一つ目は、 開始日と終了日の順番です。 順番を間違えるとマイナス値になります。

二つ目は、 日付のみを扱いたい場合は、 LocalDateを使うことです。

時刻まで扱いたい場合は、 LocalDateTimeを使う必要があります。

三つ目は、 Java標準APIを利用することで、 うるう年なども自動的に考慮される点です。

Javaの日時計算は、 会員管理システム、 予約システム、 勤怠管理システムなど、 さまざまな業務システムで利用されています。

そのため、 ChronoUnit.DAYSと betweenメソッドは、 Java初心者の方でも早めに覚えておきたい重要な知識です。

まとめ

まとめ

今回は、 JavaのChronoUnit.DAYSと betweenメソッドを使った日数計算について詳しく学びました。

Java初心者の方は、 日付の差分計算を難しく感じることがありますが、 Javaの日時APIを利用することで、 非常にシンプルかつ安全に実装できます。

特に、 ChronoUnit.DAYS.betweenは、 二つの日付の差を日数単位で取得できる便利な機能です。 Javaの業務システムでは、 経過日数、 利用期間、 契約期間、 勤務日数、 予約日数などを計算する場面が数多く存在します。

そのため、 Javaの日時APIを理解しておくことは、 Javaエンジニアとして非常に重要です。

Javaでは、 古いDateクラスや Calendarクラスを利用する方法もありますが、 現在では LocalDateや ChronoUnitを利用する方法が推奨されています。

日数計算を復習するサンプル

まずは、 Javaの日数計算を復習するサンプルプログラムを見てみましょう。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class ReviewDaysExample {
    public static void main(String[] args) {

        LocalDate startDate = LocalDate.of(2025, 5, 1);
        LocalDate endDate = LocalDate.of(2025, 5, 20);

        long days = ChronoUnit.DAYS.between(startDate, endDate);

        System.out.println("日数差：" + days);
    }
}

日数差：19

このように、 Javaでは非常に短いコードで日数差を取得できます。

Java初心者の方でも、 処理内容を理解しやすい点が大きなメリットです。

betweenメソッドが便利な理由

Javaのbetweenメソッドには、 多くのメリットがあります。

Javaでは、 「読みやすいコードを書くこと」が非常に重要です。 ChronoUnit.DAYS.betweenを利用することで、 シンプルな日付計算を実現できます。

経過日数を取得するサンプル

Javaでは、 会員登録からの経過日数や、 注文からの経過日数などを求めることがあります。

次のサンプルでは、 登録日から現在までの経過日数を取得しています。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class PassedDaysExample {
    public static void main(String[] args) {

        LocalDate registerDate = LocalDate.of(2025, 1, 1);
        LocalDate today = LocalDate.now();

        long days = ChronoUnit.DAYS.between(registerDate, today);

        System.out.println("経過日数：" + days);
    }
}

経過日数：125

JavaのWebシステムや会員管理システムでは、 このような日数計算が頻繁に登場します。

LocalDateを使うメリット

Javaの日付計算では、 LocalDateを利用することが一般的です。

LocalDateは、 年月日だけを扱うため、 シンプルに日付処理を実装できます。

時間情報を含まないため、 日数計算を行う際に非常に扱いやすい点が特徴です。

import java.time.LocalDate;

public class TodayExample {
    public static void main(String[] args) {

        LocalDate today = LocalDate.now();

        System.out.println("今日の日付：" + today);
    }
}

今日の日付：2026-05-06

Java初心者の方は、 まずLocalDateと ChronoUnitの基本を覚えることで、 日時処理を理解しやすくなります。

マイナス値に注意する

Javaのbetweenメソッドでは、 開始日と終了日の順番が重要です。

開始日が未来の日付になっている場合、 結果はマイナス値になります。

Javaの日付計算でよくあるミスの一つなので、 初心者の方は特に注意しましょう。

Javaの日時APIを学ぶ重要性

Javaでは、 日付や時間を扱う処理が非常に多く存在します。

例えば、 予約管理システム、 会員管理システム、 勤怠管理システム、 ECサイト、 在庫管理システムなど、 さまざまな業務システムで日時処理が利用されています。

そのため、 Javaの日時APIを理解しておくことで、 実践的なプログラムを書けるようになります。

特に、 ChronoUnit.DAYSと betweenメソッドは、 Java初心者でも比較的理解しやすく、 実務でも利用頻度が高い重要な知識です。

Javaの日時計算を学ぶことで、 システム開発の幅も大きく広がります。

日付比較を行うサンプル

Javaでは、 日付同士を比較する処理も頻繁に利用されます。

import java.time.LocalDate;

public class CompareDateExample {
    public static void main(String[] args) {

        LocalDate date1 = LocalDate.of(2025, 5, 1);
        LocalDate date2 = LocalDate.of(2025, 5, 10);

        System.out.println(date1.isBefore(date2));
    }
}

true

このように、 Javaの日時APIを利用すると、 日付比較も簡単に実装できます。