JavaのLocalDate.minusMonthsの使い方を完全ガイド！初心者向け日付操作の基本

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

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

Javaのjava.timeパッケージは、日付と時刻を扱うための新しいAPIを提供するもので、Java 8以降から導入されました。従来のjava.util.DateやCalendarに比べて使いやすく、安全で、より直感的に日付操作ができるのが特徴です。

このパッケージの中には、LocalDate、LocalTime、LocalDateTimeなど、用途に応じたクラスが揃っており、それぞれ時間や日付の操作が簡単に行えます。

2. LocalDateクラスの基本

2. LocalDateクラスの基本

LocalDateクラスは、日付（年・月・日）のみを扱うクラスです。時刻やタイムゾーンの情報は含まれておらず、純粋に日付操作に特化しています。

例えば、今日の日付を取得したいときは以下のように記述します。

import java.time.LocalDate;

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

3. minusMonthsメソッドとは？

3. minusMonthsメソッドとは？

minusMonthsメソッドは、指定した月数だけ過去にさかのぼったLocalDateインスタンスを返すメソッドです。

元の日付オブジェクトは変更されず、新しい日付オブジェクトが返ってくるのが特徴です。例えば「3か月前の日付を取得したい」ときに使えます。

4. LocalDate.minusMonthsの使い方（基本編）

4. LocalDate.minusMonthsの使い方（基本編）

ここでは実際にminusMonthsを使って、3か月前の日付を求めてみましょう。

import java.time.LocalDate;

public class MinusMonthsExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate threeMonthsAgo = today.minusMonths(3);
        System.out.println("今日の日付: " + today);
        System.out.println("3か月前の日付: " + threeMonthsAgo);
    }
}

今日の日付: 2025-09-04
3か月前の日付: 2025-06-04

このように、現在日付から指定した月数を引くことで、簡単に過去の日付が取得できます。

5. minusMonthsで年をまたぐケースも自動対応

5. minusMonthsで年をまたぐケースも自動対応

minusMonthsは、月を引いた結果が前年になる場合も自動で処理してくれます。たとえば、1月から2か月前を求めると、前年の11月になります。

import java.time.LocalDate;

public class CrossYearExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2025, 1, 15);
        LocalDate result = date.minusMonths(2);
        System.out.println("元の日付: " + date);
        System.out.println("2か月前の日付: " + result);
    }
}

元の日付: 2025-01-15
2か月前の日付: 2024-11-15

このように、minusMonthsメソッドはうるう年や月末の日付を自動で調整してくれるため、初心者でも安心して使うことができます。

6. マイナスの値やゼロを指定した場合

6. マイナスの値やゼロを指定した場合

minusMonthsメソッドには、マイナスの値や0を指定することも可能です。

• 0：現在と同じ日付が返る
• マイナス値：未来の日付が返る（plusMonthsと同様の効果）

import java.time.LocalDate;

public class NegativeMonthsExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今日: " + today);
        System.out.println("0か月前: " + today.minusMonths(0));
        System.out.println("-2か月前: " + today.minusMonths(-2));
    }
}

今日: 2025-09-04
0か月前: 2025-09-04
-2か月前: 2025-11-04

誤ってマイナスの値を使ってもエラーにはなりませんが、意味が逆転する点に注意しましょう。

7. minusMonthsを活用した実用例

7. minusMonthsを活用した実用例

現実のプログラムでは、以下のような用途でminusMonthsを使うことがよくあります。

• 契約日から数か月前の更新日を自動算出
• ブログやニュースサイトで「○か月前の記事」を抽出
• 売上管理システムで過去数か月のデータを集計

たとえば「1年前の同じ月」などを比較する処理にも簡単に使えるため、日付計算が必要な場面では欠かせないメソッドです。

8. LocalDateとminusMonthsの組み合わせで安全な日付処理を

8. LocalDateとminusMonthsの組み合わせで安全な日付処理を

LocalDateとminusMonthsの組み合わせは、日付操作におけるバグの発生を防ぐためのベストプラクティスの一つです。java.timeパッケージは不変オブジェクトで構成されているため、スレッドセーフであり、複数人で開発している現場でも安心して使うことができます。

これからJavaで日付を扱う場合は、古いDateクラスではなく、ぜひこのLocalDateとminusMonthsを活用してみてください。

まとめ

まとめ

LocalDateとminusMonthsの基本を振り返る

Javaのjava timeパッケージに含まれるLocalDateクラスとminusMonthsメソッドは 日付操作を安全かつ簡単に実現するための重要な機能です Java初心者にとって日付処理はつまずきやすいポイントですが LocalDateを使うことで直感的に理解しやすくなります minusMonthsは指定した月数だけ過去の日付を取得するメソッドであり 元のオブジェクトを変更せず新しい日付を返すという特徴があります この不変オブジェクトという考え方は Javaプログラミングにおいて非常に重要な概念であり バグの発生を防ぐ大きなポイントになります

日付計算における重要なポイント

minusMonthsメソッドは単純に月を引くだけでなく 年をまたぐ場合でも正しく計算されるため 実務でも安心して利用できます 例えば一月から二か月前を計算すると前年の十一月になるなど 自動で年の調整が行われます またマイナス値を指定した場合は未来の日付になるという仕様も重要です これはplusMonthsと同じ動作になるため 意図せず値を間違えると逆の結果になる可能性があります Java初心者はこの点に特に注意する必要があります

実務での活用シーンとメリット

LocalDateとminusMonthsは実際の開発でも非常に多く使われています 例えば売上分析システムで過去数か月のデータを集計したり ブログ記事の公開日から何か月前かを判定したり 契約更新日を計算する処理などに利用されます 日付処理はシステムの信頼性に直結するため 正確な計算が求められます java timeパッケージを使うことで従来のDateやCalendarに比べてバグを減らし 安全に開発を進めることができます

サンプルプログラムで理解を深める

以下のサンプルでは LocalDateとminusMonthsを使って現在日付と三か月前の日付を取得し表示しています Java初心者でも理解しやすい基本的なコード例です

import java.time.LocalDate;

public class SummaryMinusMonthsExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate threeMonthsAgo = today.minusMonths(3);

        System.out.println("今日の日付: " + today);
        System.out.println("三か月前の日付: " + threeMonthsAgo);
    }
}

今日の日付: 2025-09-04
三か月前の日付: 2025-06-04

このように minusMonthsメソッドを使うことで 複雑な計算を行わずに簡単に日付を操作できます Javaプログラミングにおいて日付処理は頻繁に登場するため この書き方をしっかり覚えておくことが重要です

LocalDateを使うべき理由

java timeパッケージのLocalDateはスレッドセーフであり 不変オブジェクトとして設計されています そのため複数の処理が同時に動くシステムでも安心して利用できます またコードの可読性も高く 初心者から上級者まで幅広く使われています Javaで日付操作を行う場合は LocalDateとminusMonthsを組み合わせることで 安全で分かりやすいプログラムを書くことができます