カテゴリ: Java 更新日: 2026/10/01

JavaのLocalDateクラスのminusWeeksメソッドを完全ガイド!初心者でもわかる週数を引く方法

LocalDateのminusWeeksメソッド
LocalDateのminusWeeksメソッド

先生と生徒の会話形式で理解しよう

生徒

「Javaで今日から1週間前や3週間前の日付を求めたいのですが、簡単な方法はありますか?」

先生

「Javaでは、LocalDateクラスのminusWeeksメソッドを使うと、指定した週数を引いた日付を簡単に求められます。」

生徒

「1週間を7日として自分で計算しなくてもいいんですか?」

先生

「はい。minusWeeksを使えば、何週間前の日付を求めているのかコードからも分かりやすくなります。LocalDateの基本やminusDaysとの違いも含めて確認していきましょう。」

1. JavaのLocalDateクラスとは?

1. JavaのLocalDateクラスとは?
1. JavaのLocalDateクラスとは?

JavaのLocalDateクラスは、年、月、日で構成される日付を扱うためのクラスです。java.timeパッケージに含まれており、Java 8から利用できます。現在の日付を取得したり、指定した日付を作成したり、日付を加算したり減算したりするときに利用されます。

LocalDateが扱うのは日付だけです。時、分、秒などの時刻情報やタイムゾーンの情報は持ちません。そのため、予約日、申込日、契約日、入社日、商品の発売日、イベント開催日など、時間までは必要としない日付を管理するときに便利です。

Java初心者の方は、LocalDateをカレンダーの日付をプログラムで扱うための専用クラスと考えると分かりやすいでしょう。例えば、2026年10月1日という日付を作成する場合は、次のようにLocalDate.ofメソッドを使用します。


import java.time.LocalDate;

public class LocalDateExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 10, 1);

        System.out.println(date);
    }
}

2026-10-01

LocalDate.ofでは、年、月、日の順番で値を指定します。作成したLocalDateに対して今回学習するminusWeeksメソッドを利用すると、1週間前や2週間前など、指定した週数だけ過去の日付を求めることができます。

LocalDateはjava.timeパッケージに含まれています。Javaで日付だけを扱うプログラムを作るときに基本となるクラスなので、日付計算と一緒に使い方を覚えておきましょう。

2. minusWeeksメソッドとは?

2. minusWeeksメソッドとは?
2. minusWeeksメソッドとは?

JavaのLocalDateクラスに用意されているminusWeeksメソッドは、基準となる日付から指定した週数を引き、新しいLocalDateを取得するためのメソッドです。名前にあるminusは減らすという意味で、Weeksは週を表しています。

例えば、2026年10月15日から1週間前の日付を求める場合はminusWeeks(1)を使います。2週間前ならminusWeeks(2)、5週間前ならminusWeeks(5)と指定できます。

1週間は7日なので、自分で週数に7を掛けて日数を計算する方法も考えられます。しかし、何週間前という目的が明確な場合は、minusWeeksを使ったほうがコードを読んだときに処理の意味を理解しやすくなります。


import java.time.LocalDate;

public class MinusWeeksExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 10, 15);
        LocalDate previousWeek = date.minusWeeks(1);

        System.out.println("基準日: " + date);
        System.out.println("1週間前: " + previousWeek);
    }
}

基準日: 2026-10-15
1週間前: 2026-10-08

この例では、2026年10月15日から1週間を引いているため、結果は2026年10月8日になります。minusWeeksの引数にはlong型の値を指定し、戻り値として計算後の日付を表すLocalDateが返されます。

Javaで過去の日付を求める処理では、年、月、週、日など、どの単位で日付を移動したいのかを意識することが大切です。週単位で日付を減算したい場合には、minusWeeksが分かりやすい選択肢になります。

3. minusWeeksで複数週間前の日付を求める方法

3. minusWeeksで複数週間前の日付を求める方法
3. minusWeeksで複数週間前の日付を求める方法

minusWeeksメソッドでは、1週間だけでなく、複数週間をまとめて引くことができます。例えば3週間前の日付を求める場合はminusWeeks(3)、10週間前ならminusWeeks(10)と記述します。

週単位の日付計算は、毎週行われる予定や作業を管理するシステムで役立ちます。例えば、3週間前の申込状況を確認したい場合、4週間前からの履歴を検索したい場合、定期的な作業の過去の日程を求めたい場合などに利用できます。


import java.time.LocalDate;

public class MultipleWeeksExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 10, 20);

        LocalDate threeWeeksAgo = date.minusWeeks(3);
        LocalDate fiveWeeksAgo = date.minusWeeks(5);

        System.out.println("基準日: " + date);
        System.out.println("3週間前: " + threeWeeksAgo);
        System.out.println("5週間前: " + fiveWeeksAgo);
    }
}

基準日: 2026-10-20
3週間前: 2026-09-29
5週間前: 2026-09-15

このプログラムでは、基準日から3週間前と5週間前をそれぞれ計算しています。週数を引くことで月をまたぐ場合でも、LocalDateが適切な年月日を計算してくれます。

例えば10月の日付から数週間を引いた結果が9月になる場合でも、自分で月の日数を確認して計算する必要はありません。さらに、年をまたぐ計算でも同じです。1月の日付から数週間を引いて前年の日付になる場合も、minusWeeksを利用すれば適切なLocalDateを取得できます。

初心者の方は、日付計算を単純な数値の引き算として考えてしまうことがあります。しかし、月によって日数は異なり、年をまたぐこともあります。JavaのLocalDateに用意されている日付計算メソッドを利用すれば、このようなカレンダー上の計算を任せることができます。

4. minusWeeksを使っても元の日付は変更されない

4. minusWeeksを使っても元の日付は変更されない
4. minusWeeksを使っても元の日付は変更されない

JavaのLocalDateでminusWeeksを使うときに、初心者が特に覚えておきたいのがイミュータブルという特徴です。イミュータブルとは、作成されたオブジェクトそのものの内容が後から変更されない性質を意味します。

LocalDateはイミュータブルなクラスなので、minusWeeksを呼び出しても元の日付が直接変更されるわけではありません。指定した週数を引いた結果を表す新しいLocalDateが返されます。

例えば2026年8月20日を表す変数に対してminusWeeks(2)を実行しても、元の変数が自動的に2026年8月6日へ変わるわけではありません。計算後の日付を利用したい場合は、戻り値を変数へ代入する必要があります。


import java.time.LocalDate;

public class ImmutableWeeksExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 8, 20);
        LocalDate pastDate = date.minusWeeks(2);

        System.out.println("元の日付: " + date);
        System.out.println("2週間前: " + pastDate);
    }
}

元の日付: 2026-08-20
2週間前: 2026-08-06

実行結果を見ると、元の日付は2026年8月20日のままです。そして、pastDateには2週間前の2026年8月6日が保存されています。

date.minusWeeks(2)とだけ記述して戻り値を受け取らなかった場合、計算自体は行われても、その結果を後の処理で利用できません。minusWeeksを使ったのに日付が変わらないと感じた場合は、戻り値を変数へ代入しているか確認してみましょう。

LocalDateのminusWeeksは元の日付を書き換えません。計算後の日付を使う場合は、戻り値として返された新しいLocalDateを受け取ることが重要です。

5. minusWeeksとminusDaysの違い

5. minusWeeksとminusDaysの違い
5. minusWeeksとminusDaysの違い

Javaで過去の日付を計算するとき、minusWeeksとよく似たメソッドにminusDaysがあります。minusWeeksは週単位で日付を引くメソッドで、minusDaysは日単位で日付を引くメソッドです。

1週間は7日なので、minusWeeks(1)とminusDays(7)は同じ日付になります。また、minusWeeks(3)とminusDays(21)も同じ日付を表します。

それでは、どちらを使ってもよいように感じるかもしれません。実際のプログラムでは、処理の目的が何週間前なのか、何日前なのかによって使い分けるとコードが分かりやすくなります。


import java.time.LocalDate;

public class WeeksAndDaysExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 11, 30);

        LocalDate byWeeks = date.minusWeeks(2);
        LocalDate byDays = date.minusDays(14);

        System.out.println("2週間前: " + byWeeks);
        System.out.println("14日前: " + byDays);
    }
}

2週間前: 2026-11-16
14日前: 2026-11-16

この例では、2週間前と14日前の結果が同じになっています。しかし、例えば毎週行う作業の2週間前を求めるという処理であれば、minusWeeks(2)と書いたほうが週単位の計算であることが伝わりやすくなります。

一方、申込日から14日前という条件が決められている場合には、minusDays(14)と記述したほうが条件をそのままコードへ表現できます。結果だけではなく、プログラムを読む人が処理の意味を理解しやすいメソッドを選ぶことも大切です。

日付を引くときの基本的な使い分け

何年前ならminusYearsを利用します。

何か月前ならminusMonthsを利用します。

何週間前ならminusWeeksを利用します。

何日前ならminusDaysを利用します。

6. 現在の日付から何週間前の日付を求める方法

6. 現在の日付から何週間前の日付を求める方法
6. 現在の日付から何週間前の日付を求める方法

LocalDateのminusWeeksメソッドは、現在の日付を取得するLocalDate.nowと組み合わせることもできます。これにより、プログラムを実行した日を基準として1週間前や4週間前などの日付を求められます。

例えば、最近4週間の履歴を検索するための開始日を作成したい場合や、現在から一定の週数だけ前の日付を基準にデータを取得したい場合などに利用できます。


import java.time.LocalDate;

public class CurrentWeeksExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate fourWeeksAgo = today.minusWeeks(4);

        System.out.println("今日: " + today);
        System.out.println("4週間前: " + fourWeeksAgo);
    }
}

LocalDate.now()は、プログラムを実行したときの現在の日付を取得します。そのため、このサンプルプログラムの実行結果は実行する日によって変化します。

実際のアプリケーションでは現在の日付を基準に計算する場面が多くありますが、Javaの日付計算を学習するときは固定された日付も活用すると理解しやすくなります。LocalDate.ofを使えば毎回同じ基準日から計算できるため、期待した結果になっているか確認しやすくなります。

まず固定の日付でminusWeeksの使い方を確認し、その後でLocalDate.nowと組み合わせると、Java初心者でも現在日付を使った実践的な処理へ段階的に進めます。

7. minusWeeksとplusWeeksの違い

7. minusWeeksとplusWeeksの違い
7. minusWeeksとplusWeeksの違い

LocalDateには、週数を引くminusWeeksだけでなく、週数を加えるplusWeeksメソッドも用意されています。過去の日付を求める場合はminusWeeks、未来の日付を求める場合はplusWeeksと考えると分かりやすいでしょう。

例えば、基準日の2週間前を求める場合はminusWeeks(2)を使用します。反対に、基準日の2週間後を求める場合はplusWeeks(2)を使用できます。


import java.time.LocalDate;

public class PlusMinusWeeksExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 12, 10);

        LocalDate past = date.minusWeeks(2);
        LocalDate future = date.plusWeeks(2);

        System.out.println("基準日: " + date);
        System.out.println("2週間前: " + past);
        System.out.println("2週間後: " + future);
    }
}

基準日: 2026-12-10
2週間前: 2026-11-26
2週間後: 2026-12-24

このように、同じ基準日から過去と未来の両方の日付を簡単に求められます。予約日から2週間前に案内を行う処理や、申込日から2週間後の日付を求める処理など、週単位の予定を扱う場面で便利です。

java.timeパッケージの日付計算メソッドには規則的な名前が付けられています。minusは引く処理、plusは加える処理です。そしてYears、Months、Weeks、Daysによって計算する単位を区別できます。

この規則を理解しておくと、初めて見る日付計算のコードでも処理内容を予想しやすくなります。Javaで日付を扱う場合は、個別のメソッド名をばらばらに暗記するのではなく、名前の規則性を意識して覚えるとよいでしょう。

8. minusWeeksを実務で活用する場面

8. minusWeeksを実務で活用する場面
8. minusWeeksを実務で活用する場面

minusWeeksは、単純な学習用の日付計算だけでなく、週単位で予定や履歴を扱うさまざまなシステムへ応用できます。例えば予約管理、イベント管理、勤怠管理、顧客管理、申込管理、商品管理、履歴検索などでは、何週間前という条件で日付を計算したい場合があります。

予約システムで予約日の2週間前を求めれば、事前案内を行う基準日として利用できます。イベント管理システムでは、開催日の4週間前を申込開始日として計算することも考えられます。顧客管理システムでは、現在から8週間前の日付を求め、その日以降に登録された情報を検索するといった使い方もできます。

週単位の計算では曜日が維持されることも覚えておくと便利です。1週間は7日なので、月曜日から1週間を引いた日付も月曜日になります。同じように、金曜日から3週間を引いた日付も金曜日です。そのため、毎週同じ曜日に行われる予定の日付計算にも利用しやすい特徴があります。

ただし、minusWeeksが表している1週間は単純に7日間です。月曜日から日曜日までを1つの週として区切り、その週の開始日を自動的に取得するためのメソッドではありません。

例えば水曜日の日付にminusWeeks(1)を使えば、前週の月曜日になるのではなく、7日前の水曜日になります。週の開始日を求めたい場合には曜日を扱う別の処理が必要です。何週間前の日付を求めることと、前の週の先頭の日付を求めることは別の処理として考えましょう。

minusWeeks(1)は7日前の日付を返します。前週の月曜日や前週の開始日を自動的に求める機能ではないため、週単位の集計処理を作る場合は目的を確認して使い分けることが大切です。

また、4週間前と1か月前も必ず同じ日付になるわけではありません。4週間は28日ですが、1か月の日数は月によって異なります。何週間前という条件ならminusWeeks、何か月前という条件ならminusMonthsを使用し、処理の意味に合った単位で日付を計算しましょう。

9. Java初心者がminusWeeksを使うときの注意点

9. Java初心者がminusWeeksを使うときの注意点
9. Java初心者がminusWeeksを使うときの注意点

Java初心者がLocalDate.minusWeeksを使うときは、まず元のLocalDateが変更されないことを覚えておきましょう。LocalDateはイミュータブルなので、計算結果として新しい日付が返されます。戻り値を受け取らなければ、計算後の日付を後の処理で利用できません。

次に、minusWeeksは指定した週数に相当する日数だけ過去へ移動する処理であることを理解しておきましょう。1週間なら7日前、2週間なら14日前、3週間なら21日前です。そのため、同じ曜日を保ったまま過去の日付へ移動できます。

一方で、minusWeeksは前週の先頭や月曜日を探すための機能ではありません。例えば木曜日から1週間を引けば前週の木曜日になります。週ごとの売上集計などで前週の月曜日から日曜日までを求めたい場合は、曜日を考慮した別の日付計算が必要になります。

また、4週間と1か月を同じものとして扱わないことも大切です。4週間は常に28日ですが、1か月には28日、29日、30日、31日の場合があります。月単位で過去へ移動したいのであればminusMonthsを使用します。

minusWeeksには0を指定することもできます。minusWeeks(0)では日付が移動しないため、結果は元と同じ日付になります。また、負の値を指定すると計算方向が反対になります。例えばminusWeeks(-1)では結果として1週間後の日付になります。

ただし、未来の日付を求める目的で負の値を多用すると、コードを読む人が意味を理解しにくくなる場合があります。1週間後を求めたいのであれば、通常はplusWeeks(1)と記述したほうが目的が明確です。

非常に大きな週数を指定して、LocalDateで表現可能な日付の範囲を超えた場合には例外が発生する可能性があります。通常の学習や一般的な業務で扱う週数では問題になることは多くありませんが、利用者から受け取った数値をそのまま計算に使用する場合は、想定した範囲の値か確認することも重要です。

minusWeeksで覚えておきたいポイント

LocalDateはjava.timeパッケージに含まれています。

minusWeeksは指定した週数を引いた日付を取得します。

1週間前ならminusWeeks(1)を使用します。

戻り値は新しいLocalDateです。

元のLocalDateの日付は変更されません。

1週間は7日なので、minusWeeks(1)は7日前の日付になります。

何日前という条件ならminusDaysを利用できます。

何か月前という条件ならminusMonthsを利用できます。

週数を加える場合はplusWeeksを利用できます。

minusWeeksは前週の開始日を求めるメソッドではありません。

JavaのLocalDateとminusWeeksを学習するときは、最初に固定した日付から1週間を引く簡単なプログラムを作成すると理解しやすくなります。次に2週間前や5週間前などへ値を変更し、月や年をまたいでも正しい日付になることを確認してみましょう。

その後、元の日付と計算後の日付を両方表示すると、LocalDateがイミュータブルであることも確認できます。さらにminusDaysやminusMonths、plusWeeksと比較すると、Javaの日付計算でどのメソッドを選べばよいのか判断しやすくなります。

Javaで週単位の日付計算を行う処理は、予約システム、スケジュール管理、イベント管理、顧客管理、履歴検索、定期処理など幅広いアプリケーションで利用できます。特に毎週同じ曜日を基準にした予定では、minusWeeksを利用することで処理の意味を簡潔に表現できます。

ただし、実際のシステムでは何週間前を求めるのか、前週という期間を求めるのか、過去28日間を求めるのかによって必要な計算が異なります。Javaのメソッド名だけで判断するのではなく、システムで必要となる日付の条件を整理してから適切な方法を選びましょう。

LocalDate.minusWeeksは書き方がシンプルなメソッドですが、戻り値の扱い、イミュータブルなLocalDateの特徴、週と日の関係、週と月の違い、plusWeeksとの使い分けまで理解することで、Javaの日付操作をより正確に扱えるようになります。

まとめ

まとめ
まとめ

JavaのLocalDateクラスに用意されているminusWeeksメソッドは、基準となる日付から指定した週数を引き、何週間前の日付を求めるためのメソッドです。Javaで日付計算を行うときには、年や月や日を自分で分解して計算するのではなく、java.timeパッケージに用意されている機能を利用すると、処理の目的が分かりやすいコードを書くことができます。

LocalDateは、年、月、日を扱うためのクラスです。時、分、秒などの時刻は持たないため、予約日、申込日、契約日、イベント開催日、商品発売日、登録日など、日付だけを管理したい処理に向いています。Javaで日付を扱う基本的なクラスのため、初心者の段階から使い方を覚えておくと、さまざまなプログラムで活用できます。

minusWeeksの基本的な使い方は非常にシンプルです。1週間前の日付を求める場合はminusWeeks(1)、2週間前ならminusWeeks(2)、5週間前ならminusWeeks(5)のように、引きたい週数を引数として指定します。戻り値として、計算後の日付を表す新しいLocalDateが返されます。

minusWeeksの基本をもう1度確認しよう

例えば、2026年10月22日から3週間前の日付を求めたい場合は、次のように記述できます。3週間は21日ですが、自分で21日を計算してminusDaysを使う必要はありません。何週間前という条件であれば、minusWeeksを利用したほうがプログラムの意味を読み取りやすくなります。


import java.time.LocalDate;

public class MinusWeeksReview {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 10, 22);
        LocalDate pastDate = date.minusWeeks(3);

        System.out.println("基準日: " + date);
        System.out.println("3週間前: " + pastDate);
    }
}

基準日: 2026-10-22
3週間前: 2026-10-01

このプログラムでは、2026年10月22日を基準として3週間を引いているため、2026年10月1日が取得されます。日付計算によって月をまたぐ場合や年をまたぐ場合でも、LocalDateが適切な年月日を計算します。そのため、月ごとの日数を確認しながら自分で年月日を変更する必要はありません。

minusWeeksでは、1週間を7日として日付が移動します。そのため、月曜日から1週間を引けば前の月曜日になり、金曜日から4週間を引けば4週間前の金曜日になります。同じ曜日を維持しながら週単位で過去の日付を求められる点は、毎週決まった曜日に行われる予定や処理を扱うときにも便利です。

元のLocalDateが変更されないことが重要

LocalDateを使ううえで特に重要なのが、イミュータブルという特徴です。イミュータブルとは、作成されたオブジェクトそのものの内容が後から変更されない性質です。minusWeeksを実行しても、元のLocalDateの日付が書き換えられるわけではありません。

例えば、変数に2026年12月15日が入っている状態でminusWeeks(2)を実行すると、2週間前の日付を表す新しいLocalDateが返されます。元の変数には引き続き2026年12月15日が入っています。そのため、計算結果を使いたい場合には戻り値を受け取る必要があります。


import java.time.LocalDate;

public class LocalDateImmutableReview {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 12, 15);
        LocalDate twoWeeksAgo = date.minusWeeks(2);

        System.out.println("元の日付: " + date);
        System.out.println("2週間前: " + twoWeeksAgo);
    }
}

元の日付: 2026-12-15
2週間前: 2026-12-01

初心者が日付計算で間違えやすいのが、date.minusWeeks(2)と実行するだけでdateの中身も変わったと考えてしまうことです。計算後の日付が必要なら、別の変数へ代入するか、必要に応じてdate = date.minusWeeks(2)のように戻り値を改めて代入します。

LocalDateはイミュータブルなクラスです。minusWeeksを呼び出しただけでは元の日付は変更されないため、計算後の日付を利用するときは戻り値を受け取ることを忘れないようにしましょう。

minusWeeksと他の日付計算メソッドを使い分けよう

JavaのLocalDateには、週数を引くminusWeeks以外にも、さまざまな日付計算メソッドが用意されています。何年前の日付を求めるならminusYears、何か月前ならminusMonths、何日前ならminusDaysを利用できます。未来の日付を求める場合には、plusYears、plusMonths、plusWeeks、plusDaysなどを利用できます。

ここで大切なのは、計算結果だけではなく、何を基準に日付を計算したいのかを考えることです。例えば2週間前という条件であればminusWeeks(2)が自然です。14日前という条件ならminusDays(14)と記述したほうが、プログラムを読んだ人にも処理の目的が伝わります。

minusWeeks(4)とminusMonths(1)も同じ意味ではありません。4週間は28日ですが、1か月の日数は月によって変わります。何週間前なのか、何か月前なのかという業務上の条件を確認して、適切なメソッドを選択する必要があります。

LocalDateの日付計算で確認したいポイント

何年前の日付を求める場合はminusYearsを利用します。

何か月前の日付を求める場合はminusMonthsを利用します。

何週間前の日付を求める場合はminusWeeksを利用します。

何日前の日付を求める場合はminusDaysを利用します。

未来の日付を週単位で求める場合はplusWeeksを利用します。

日付計算では結果だけでなく、プログラムが表している期間の意味に合ったメソッドを選ぶことが大切です。

現在の日付から何週間前かを求める場合

実際のJavaアプリケーションでは、固定された日付だけでなく、現在の日付を基準にして何週間前の日付を求める処理もよく使われます。その場合はLocalDate.nowで現在の日付を取得し、その結果に対してminusWeeksを使用できます。

例えば、現在から8週間前までの履歴を検索したい場合には、検索対象となる開始日を次のように作成できます。予約管理、顧客管理、商品管理、申込管理などで一定期間のデータを検索するときにも応用できます。


import java.time.LocalDate;

public class HistoryDateExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate startDate = today.minusWeeks(8);

        System.out.println("現在の日付: " + today);
        System.out.println("8週間前: " + startDate);
    }
}

LocalDate.now()はプログラムを実行した日の情報を取得するため、実行する日によって結果が変化します。学習中に毎回同じ結果を確認したい場合はLocalDate.ofで固定した日付を作り、実際のシステムで現在の日付が必要になったらLocalDate.nowを利用すると理解しやすいでしょう。

前週の開始日を求める処理とは区別しよう

minusWeeksについて理解するときには、何週間前の日付を求める処理と、前週の開始日を求める処理を区別することも重要です。minusWeeks(1)は現在の日付から7日前へ移動する処理であり、自動的に前週の月曜日を返すわけではありません。

例えば基準日が木曜日なら、minusWeeks(1)で取得される日付も木曜日です。週ごとの売上を月曜日から日曜日まで集計したい場合などは、単純にminusWeeksを使うだけではなく、曜日を確認して週の開始日や終了日を求める処理が必要になります。

一方、予約日の2週間前、イベント開催日の4週間前、現在から8週間前といったように、基準日から一定の週数だけ過去へ移動することが目的ならminusWeeksが適しています。この違いを理解しておけば、週単位の日付計算で意図しない結果になることを防ぎやすくなります。

実務で使うときは処理の意味を明確にしよう

JavaのLocalDate.minusWeeksは、予約システム、イベント管理、勤怠管理、顧客管理、履歴検索、定期処理など幅広い場面で利用できます。例えばイベント開催日の3週間前に案内を開始したい場合や、予約日の1週間前に確認処理を行いたい場合など、週を基準にした日付計算に向いています。

プログラムを書くときには、単に正しい日付が表示されればよいと考えるのではなく、コードを読んだ人が処理の意味を理解できることも重要です。7日前を意味する処理ならminusDays(7)、1週間前を意味する処理ならminusWeeks(1)と記述すると、同じ計算結果でも目的をコードから読み取りやすくなります。

また、minusWeeksへ0を指定すると元と同じ日付が返されます。負の値を指定すると未来方向へ移動することもできますが、未来の日付を求めるのであればplusWeeksを使うほうが処理の意図を理解しやすくなります。Javaの日付操作では、動作するコードだけでなく、読みやすく意味の伝わるコードを書くことを意識しましょう。

Java初心者の方は、まずLocalDate.ofで日付を作り、minusWeeks(1)で1週間前を取得するところから練習するとよいでしょう。その後、引く週数を2や5へ変更したり、月や年をまたぐ日付を試したりすると、LocalDateによる日付計算の仕組みをより具体的に理解できます。

さらに、minusDaysやminusMonths、minusYearsと比較しながら動作を確認すると、Javaの日時処理全体への理解も深まります。LocalDateには日付を扱うための便利なメソッドが数多く用意されているため、年、月、週、日のどの単位で計算するのかを整理しながら使い分けることが大切です。

Javaで何週間前の日付を求めたい場合はLocalDateのminusWeeksが利用できます。元の日付が変更されないこと、1週間は7日として計算されること、前週の開始日を求める機能ではないことを一緒に覚えておくと、週単位の日付計算を正しく使いやすくなります。
先生と生徒の振り返り会話

生徒

「minusWeeksは、指定した週数だけ前の日付を取得するときに使うメソッドなんですね。」

先生

「その通りです。例えば1週間前ならminusWeeks(1)、3週間前ならminusWeeks(3)と書けます。何週間前という条件をそのままコードで表現できるところが分かりやすいですね。」

生徒

「1週間前ならminusDays(7)でも同じ日付になりますよね。」

先生

「はい。計算結果は同じです。ただし、条件が1週間前ならminusWeeks(1)、条件が7日前ならminusDays(7)と書くと、何を基準に計算しているのかが伝わりやすくなります。」

生徒

「minusWeeksを使うと、元の日付自体も過去の日付に変わりますか?」

先生

「変わりません。LocalDateはイミュータブルなので、minusWeeksは計算後の日付を表す新しいLocalDateを返します。結果を使う場合は戻り値を変数へ代入してください。」

生徒

「では、月曜日から1週間前を求めると、前の月曜日になるということですか?」

先生

「はい。1週間は7日なので曜日は同じです。ただし、minusWeeksが前週の月曜日を探しているわけではありません。例えば木曜日から1週間を引けば、7日前の木曜日になります。」

生徒

「4週間前と1か月前も同じではないんですね。」

先生

「そこも大切なポイントです。4週間は28日ですが、1か月の日数は一定ではありません。何週間前ならminusWeeks、何か月前ならminusMonthsというように、目的に合わせて使い分けましょう。」

生徒

「現在の日付から8週間前を求めたいときは、LocalDate.nowと組み合わせればいいですか?」

先生

「はい。現在の日付をLocalDate.nowで取得して、その日付にminusWeeks(8)を使えば8週間前の日付を取得できます。履歴検索や予約管理などにも応用できます。」

生徒

「年、月、週、日で、それぞれ専用のメソッドを使い分けると分かりやすいですね。」

先生

「そうですね。JavaのLocalDateでは、何年前、何か月前、何週間前、何日前という目的に合わせてメソッドを選べます。まずはminusWeeksで週単位の日付計算に慣れてから、ほかの日付操作も組み合わせて練習していきましょう。」

生成AIを基礎から学びたい方へ

ChatGPTなどの生成AIをこれから学びたい方に向けて、AIスキルアカデミーの口コミ・評判、料金、無料セミナーの内容を詳しくまとめています。

AIスキルアカデミーの口コミ・評判を詳しく見る
カテゴリの一覧へ
新着記事
New1
JSP
EL式の基本構文まとめ!${}で使う書き方のルールを解説
更新記事
New2
Java
Javaのjava.mathとBigIntegerのintValueメソッドを完全解説!初心者でもわかる数値変換の基本
更新記事
New3
Java
JavaのBigIntegerクラスとmodメソッドを完全解説!余り計算を初心者向けにやさしく理解しよう
更新記事
New4
Java
JavaのBigIntegerとvalueOfを完全解説!初心者でもわかる大きな整数の安全な扱い方
更新記事
人気記事
No.1
Java&Spring記事人気No1
Servlet
JavaのGenericServletクラスの使い方を徹底解説!初心者でもわかるServletの基本とHttpServletとの違い
No.2
Java&Spring記事人気No2
Servlet
JavaのHttpServletRequestWrapperとauthenticateメソッドとは?初心者にもわかりやすく解説!
No.3
Java&Spring記事人気No3
Servlet
JavaのHttpServletRequestWrapperとlogoutメソッドを完全ガイド!初心者でもわかるログアウト処理の方法
No.4
Java&Spring記事人気No4
Servlet
JavaのHttpServletRequestWrapperとgetMethodメソッドの使い方を徹底解説!初心者向けHTTPリクエストメソッド取得ガイド
No.5
Java&Spring記事人気No5
Servlet
JavaのHttpServletRequestWrapperとgetUserPrincipalメソッドを徹底解説!初心者でもわかる認証ユーザー情報の取得方法
No.6
Java&Spring記事人気No6
Servlet
JavaのHttpServletRequestWrapperとupgradeメソッドを徹底解説!初心者でもわかるプロトコルアップグレードの基本
No.7
Java&Spring記事人気No7
Java
Java Streamのgenerateメソッド完全ガイド!初心者でもわかる乱数と定数ストリーム生成
No.8
Java&Spring記事人気No8
Servlet
JavaのサーブレットのdoGetメソッドとは?GETリクエストの仕組みと使い方を初心者向けに徹底解説