Java – 2つの年月の差分を計算する方法

2025-04-15更新日: 2025-04-15

Javaで2つの年月の差分を計算するには、java.timeパッケージを使用します。

YearMonthクラスを用いると、年月を簡潔に扱えます。

例えば、YearMonthオブジェクトを作成し、PeriodクラスやChronoUnit.YEARS/ChronoUnit.MONTHSを使って差分を計算します。

これにより、年単位や月単位での差分を取得可能です。

LocalDateやLocalDateTimeを使う場合も同様のアプローチが取れます。

目次から探す

YearMonthクラスを使った年月の差分計算
- YearMonthクラスの基本
Periodクラスを使った年月の差分計算
- Periodクラスの基本
ChronoUnitを使った年月の差分計算
- ChronoUnitクラスの基本
LocalDateを使った年月の差分計算
- LocalDateクラスの基本
エラーハンドリングと例外処理
- 例外処理の基本
まとめ

YearMonthクラスを使った年月の差分計算

JavaのYearMonthクラスは、年と月を表現するための便利なクラスです。

このクラスを使用することで、2つの年月の差分を簡単に計算することができます。

以下に、YearMonthクラスを使った年月の差分計算の方法を示します。

YearMonthクラスの基本

YearMonthクラスは、java.timeパッケージに含まれており、年と月の情報を持つオブジェクトを作成できます。

以下のように、YearMonthオブジェクトを生成することができます。

import java.time.YearMonth;
public class App {
    public static void main(String[] args) {
        // YearMonthオブジェクトの生成
        YearMonth startDate = YearMonth.of(2020, 5); // 2020年5月
        YearMonth endDate = YearMonth.of(2023, 10); // 2023年10月
        // 年月の差分を計算
        int monthsBetween = calculateMonthsBetween(startDate, endDate);
        System.out.println("差分の月数: " + monthsBetween);
    }
    // 2つのYearMonthの差分を計算するメソッド
    public static int calculateMonthsBetween(YearMonth start, YearMonth end) {
        return (end.getYear() - start.getYear()) * 12 + (end.getMonthValue() - start.getMonthValue());
    }
}

このコードでは、YearMonth.of()メソッドを使用して、特定の年月を表すYearMonthオブジェクトを生成しています。

calculateMonthsBetweenメソッドでは、2つのYearMonthオブジェクトの差分を月数で計算しています。

差分の月数: 40

このように、YearMonthクラスを使用することで、簡単に年月の差分を計算することができます。

YearMonthは、特に年月の計算が必要な場合に非常に便利なクラスです。

Periodクラスを使った年月の差分計算

JavaのPeriodクラスは、日付の差分を年、月、日単位で表現するためのクラスです。

このクラスを使用することで、2つの年月の差分を簡単に計算することができます。

以下に、Periodクラスを使った年月の差分計算の方法を示します。

Periodクラスの基本

Periodクラスは、java.timeパッケージに含まれており、日付の差分を表現するために使用されます。

LocalDateと組み合わせて使用することが一般的です。

以下のコードでは、Periodクラスを使用して2つの年月の差分を計算します。

import java.time.LocalDate;
import java.time.Period;
public class App {
    public static void main(String[] args) {
        // LocalDateオブジェクトの生成
        LocalDate startDate = LocalDate.of(2020, 5, 1); // 2020年5月1日
        LocalDate endDate = LocalDate.of(2023, 10, 1); // 2023年10月1日
        // 年月の差分を計算
        Period period = calculatePeriodBetween(startDate, endDate);
        System.out.println("差分: " + period.getYears() + "年 " + period.getMonths() + "ヶ月");
    }
    // 2つのLocalDateの差分をPeriodで計算するメソッド
    public static Period calculatePeriodBetween(LocalDate start, LocalDate end) {
        return Period.between(start, end);
    }
}

このコードでは、LocalDate.of()メソッドを使用して、特定の日付を表すLocalDateオブジェクトを生成しています。

calculatePeriodBetweenメソッドでは、Period.between()メソッドを使用して2つのLocalDateオブジェクトの差分を計算し、Periodオブジェクトを返しています。

差分: 3年 5ヶ月

このように、Periodクラスを使用することで、年月の差分を年と月の単位で簡単に計算することができます。

Periodは、特に日付の差分を詳細に扱いたい場合に非常に便利なクラスです。

ChronoUnitを使った年月の差分計算

JavaのChronoUnitクラスは、時間の単位を使って日付や時間の差分を計算するための便利なクラスです。

このクラスを使用することで、2つの年月の差分を簡単に計算することができます。

以下に、ChronoUnitを使った年月の差分計算の方法を示します。

ChronoUnitクラスの基本

ChronoUnitは、java.time.temporalパッケージに含まれており、さまざまな時間単位(年、月、日など)を使用して日付の差分を計算するために使用されます。

以下のコードでは、ChronoUnitを使用して2つの年月の差分を計算します。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
public class App {
    public static void main(String[] args) {
        // LocalDateオブジェクトの生成
        LocalDate startDate = LocalDate.of(2020, 5, 1); // 2020年5月1日
        LocalDate endDate = LocalDate.of(2023, 10, 1); // 2023年10月1日
        // 年月の差分を計算
        long monthsBetween = calculateMonthsBetween(startDate, endDate);
        System.out.println("差分の月数: " + monthsBetween);
    }
    // 2つのLocalDateの差分を月数で計算するメソッド
    public static long calculateMonthsBetween(LocalDate start, LocalDate end) {
        return ChronoUnit.MONTHS.between(start, end);
    }
}

このコードでは、LocalDate.of()メソッドを使用して、特定の日付を表すLocalDateオブジェクトを生成しています。

calculateMonthsBetweenメソッドでは、ChronoUnit.MONTHS.between()メソッドを使用して2つのLocalDateオブジェクトの差分を月数で計算しています。

差分の月数: 40

このように、ChronoUnitクラスを使用することで、年月の差分を簡単に計算することができます。

ChronoUnitは、特に異なる時間単位での計算が必要な場合に非常に便利なクラスです。

LocalDateを使った年月の差分計算

JavaのLocalDateクラスは、日付を表現するためのクラスで、年月の差分を計算する際にも非常に便利です。

このクラスを使用することで、2つのLocalDateオブジェクトの差分を簡単に計算することができます。

以下に、LocalDateを使った年月の差分計算の方法を示します。

LocalDateクラスの基本

LocalDateクラスは、java.timeパッケージに含まれており、年、月、日を持つ日付を表現します。

以下のコードでは、LocalDateを使用して2つの日付の差分を計算します。

import java.time.LocalDate;
import java.time.Month;
public class App {
    public static void main(String[] args) {
        // LocalDateオブジェクトの生成
        LocalDate startDate = LocalDate.of(2020, Month.MAY, 1); // 2020年5月1日
        LocalDate endDate = LocalDate.of(2023, Month.OCTOBER, 1); // 2023年10月1日
        // 年月の差分を計算
        int monthsBetween = calculateMonthsBetween(startDate, endDate);
        System.out.println("差分の月数: " + monthsBetween);
    }
    // 2つのLocalDateの差分を月数で計算するメソッド
    public static int calculateMonthsBetween(LocalDate start, LocalDate end) {
        int yearsDifference = end.getYear() - start.getYear(); // 年の差分
        int monthsDifference = end.getMonthValue() - start.getMonthValue(); // 月の差分
        return yearsDifference * 12 + monthsDifference; // 総月数を計算
    }
}

このコードでは、LocalDate.of()メソッドを使用して、特定の日付を表すLocalDateオブジェクトを生成しています。

calculateMonthsBetweenメソッドでは、年と月の差分を計算し、総月数を返しています。

差分の月数: 40

このように、LocalDateクラスを使用することで、年月の差分を簡単に計算することができます。

LocalDateは、特に日付の計算が必要な場合に非常に便利なクラスです。

エラーハンドリングと例外処理

Javaで年月の差分を計算する際には、エラーハンドリングと例外処理が重要です。

特に、無効な日付や不正な入力があった場合に適切に対処することで、プログラムの安定性を向上させることができます。

以下に、年月の差分計算におけるエラーハンドリングの方法を示します。

例外処理の基本

Javaでは、try-catchブロックを使用して例外を捕捉し、エラーが発生した場合に適切な処理を行うことができます。

以下のコードでは、LocalDateを使用して年月の差分を計算する際に、無効な日付が入力された場合のエラーハンドリングを行います。

import java.time.LocalDate;
import java.time.Month;
import java.time.format.DateTimeParseException;
public class App {
    public static void main(String[] args) {
        try {
            // LocalDateオブジェクトの生成
            LocalDate startDate = LocalDate.of(2020, Month.MAY, 1); // 2020年5月1日
            LocalDate endDate = LocalDate.of(2023, Month.OCTOBER, 1); // 2023年10月1日
            // 年月の差分を計算
            int monthsBetween = calculateMonthsBetween(startDate, endDate);
            System.out.println("差分の月数: " + monthsBetween);
        } catch (DateTimeParseException e) {
            System.out.println("無効な日付が入力されました: " + e.getMessage());
        } catch (Exception e) {
            System.out.println("エラーが発生しました: " + e.getMessage());
        }
    }
    // 2つのLocalDateの差分を月数で計算するメソッド
    public static int calculateMonthsBetween(LocalDate start, LocalDate end) {
        if (start.isAfter(end)) {
            throw new IllegalArgumentException("開始日が終了日よりも後の日付です。");
        }
        int yearsDifference = end.getYear() - start.getYear(); // 年の差分
        int monthsDifference = end.getMonthValue() - start.getMonthValue(); // 月の差分
        return yearsDifference * 12 + monthsDifference; // 総月数を計算
    }
}

このコードでは、try-catchブロックを使用して、日付の計算中に発生する可能性のある例外を捕捉しています。

特に、開始日が終了日よりも後の日付である場合には、IllegalArgumentExceptionをスローしてエラーメッセージを表示します。