JavaのLocalDate.withメソッドの使い方を完全ガイド！初心者でもわかる日付の変更方法

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

「1. java.timeパッケージとは？」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

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

Javaのjava.timeパッケージは、日付と時間を扱うための新しいAPIで、Java8から導入されました。従来のjava.util.DateやCalendarに比べて、コードが読みやすく、安全に設計されています。

このパッケージには、LocalDate・LocalTime・LocalDateTimeなど、目的に応じて使い分けられる便利なクラスが多数用意されています。中でも、LocalDateは時間を含まない日付を表すのに最適です。

2. LocalDateクラスの基本

2. LocalDateクラスの基本

LocalDateクラスは、年月日だけを扱うシンプルな日付クラスです。時間の概念が不要な場合に便利で、「2025年9月4日」といった形式の日付を扱います。

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

import java.time.LocalDate;

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

3. withメソッドとは？

3. withメソッドとは？

withメソッドは、LocalDateクラスに用意されている日付操作メソッドの一つで、年・月・日など、特定の値だけを変更した新しいLocalDateインスタンスを返します。

このメソッドは、元の日付を変更するのではなく、新たなオブジェクトを返す不変（イミュータブル）設計になっており、安全な日付処理ができます。

4. withメソッドで年・月・日を変更する

「4. withメソッドで年・月・日を変更する」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. withメソッドで年・月・日を変更する

以下のサンプルでは、日付の年・月・日をwithメソッドで個別に変更しています。

import java.time.LocalDate;

public class WithExample {
    public static void main(String[] args) {
        LocalDate original = LocalDate.of(2023, 5, 15);
        LocalDate changedYear = original.withYear(2025);
        LocalDate changedMonth = original.withMonth(12);
        LocalDate changedDay = original.withDayOfMonth(1);

        System.out.println("元の日付：" + original);
        System.out.println("年だけ変更：" + changedYear);
        System.out.println("月だけ変更：" + changedMonth);
        System.out.println("日だけ変更：" + changedDay);
    }
}

元の日付：2023-05-15
年だけ変更：2025-05-15
月だけ変更：2023-12-15
日だけ変更：2023-05-01

このように、withYear・withMonth・withDayOfMonthを使えば、必要な部分だけを柔軟に変更できます。

5. TemporalFieldを使った応用的な変更

5. TemporalFieldを使った応用的な変更

withメソッドは、ChronoFieldなどのTemporalFieldを使って柔軟な指定もできます。

import java.time.LocalDate;
import java.time.temporal.ChronoField;

public class TemporalWithExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, 8, 10);
        LocalDate updated = date.with(ChronoField.MONTH_OF_YEAR, 2);
        System.out.println("月を2月に変更：" + updated);
    }
}

月を2月に変更：2024-02-10

この方法を使えば、日付の各フィールドをより一般的な方法で操作することができ、他のTemporal系クラスとも一貫した記述が可能になります。

6. withメソッドのよくある使用シーン

6. withメソッドのよくある使用シーン

withメソッドは以下のような場面でよく使われます。

• 日付の一部だけを変更したいとき
• 月初や月末に日付を合わせたいとき
• 特定のパターンで毎月の処理を行いたいとき
• 定期的なスケジュールを作成する際

例えば、月の初日を取得したい場合は次のように書きます。

import java.time.LocalDate;

public class FirstDayOfMonth {
    public static void main(String[] args) {
        LocalDate now = LocalDate.now();
        LocalDate firstDay = now.withDayOfMonth(1);
        System.out.println("今月の初日：" + firstDay);
    }
}

今月の初日：2025-09-01

7. イミュータブルのメリットを理解しよう

「7. イミュータブルのメリットを理解しよう」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. イミュータブルのメリットを理解しよう

LocalDateのような日付クラスが変更できない（イミュータブル）設計になっている理由は、スレッドセーフで安全なコードを書くためです。

withメソッドで新しいオブジェクトを返すことで、意図せず他の処理に影響を与えることを防げます。これにより、複数の処理や並行実行でも、安定した日付操作が可能になります。

8. java.timeとwithメソッドを使いこなそう

8. java.timeとwithメソッドを使いこなそう

Javaで日付を扱う際には、java.timeパッケージのLocalDateとwithメソッドの理解がとても重要です。年・月・日など、必要な部分だけを簡単に変更できるので、実務でも活躍する場面が多いです。

初心者でも読みやすく、安全に日付処理ができるjava.timeの設計を活かして、より信頼性の高いJavaアプリケーションを作っていきましょう。

まとめ

まとめ

本記事では、Javaの日付操作において非常に重要な役割を持つLocalDateクラスとwithメソッドの使い方について、基礎から応用まで丁寧に解説してきました。特にjava.timeパッケージの登場により、従来のDateやCalendarに比べて、より直感的で安全な日付操作が可能になった点は、現代のJava開発において見逃せないポイントです。 LocalDateは年月日のみを扱うシンプルなクラスであり、業務システムやWebアプリケーション開発など、時間を必要としない日付処理において幅広く活用されています。そして、そのLocalDateの中でもwithメソッドは、日付の一部だけを柔軟に変更できる便利なメソッドとして頻繁に利用されます。 withYearやwithMonth、withDayOfMonthといった専用メソッドを使うことで、元の日付を維持しながら特定の値だけを変更することができます。このような設計はイミュータブルという考え方に基づいており、元のオブジェクトを書き換えないため、安全性が高く、バグの発生を防ぎやすいという大きなメリットがあります。 また、ChronoFieldなどのTemporalFieldを活用することで、より汎用的な日付操作も実現できます。これにより、単純な日付変更だけでなく、複雑なロジックにも対応できる柔軟性が確保されています。 実務においては、月初や月末の取得、特定日への調整、定期処理のスケジュール生成など、withメソッドが活躍する場面は数多く存在します。たとえば請求処理やバッチ処理などでは、日付の微調整が必要になるケースが多く、こうした場面でwithメソッドの理解が大きな差となります。 さらに、java.timeの設計思想を理解することで、可読性の高いコードを書くことができ、チーム開発においても保守性の向上につながります。単に動くコードを書くのではなく、安全で意図が明確なコードを書くためにも、LocalDateとwithメソッドの使い方はしっかりと押さえておきたい重要な知識です。 本記事の内容を繰り返し確認しながら、実際にコードを書いて試すことで理解がより深まります。Javaの日付処理を自在に扱えるようになることで、開発の幅が広がり、より実践的なスキルが身につくでしょう。

サンプルプログラムで復習

最後に、withメソッドの基本的な使い方をまとめたサンプルコードを確認しておきましょう。実際に動かしながら理解を深めることが大切です。

import java.time.LocalDate;
import java.time.temporal.ChronoField;

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

        LocalDate baseDate = LocalDate.of(2023, 10, 20);

        LocalDate changeYear = baseDate.withYear(2025);
        LocalDate changeMonth = baseDate.withMonth(1);
        LocalDate changeDay = baseDate.withDayOfMonth(5);

        LocalDate changeByField = baseDate.with(ChronoField.MONTH_OF_YEAR, 12);

        System.out.println("元の日付：" + baseDate);
        System.out.println("年変更：" + changeYear);
        System.out.println("月変更：" + changeMonth);
        System.out.println("日変更：" + changeDay);
        System.out.println("フィールド変更：" + changeByField);
    }
}

元の日付：2023-10-20
年変更：2025-10-20
月変更：2023-01-20
日変更：2023-10-05
フィールド変更：2023-12-20