カテゴリ: Java 更新日: 2026/06/25

JavaのLocalDateTimeクラスwithメソッドを徹底解説!初心者でもわかる日時の変更方法

LocalDateTimeのwithメソッド
LocalDateTimeのwithメソッド

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

生徒

「先生、Javaで日時の一部だけを変更する方法ってありますか?」

先生

「はい、Javaのjava.timeパッケージにあるLocalDateTimeクラスには、withメソッドがあります。これを使えば簡単に年や月、日、時間を変更できますよ。」

生徒

「なるほど!具体的にはどうやって使うんですか?」

先生

「それでは、実際のサンプルコードを使って説明していきましょう。」

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

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

java.timeパッケージは、Java8から導入された新しい日時APIです。従来のDateやCalendarに比べて、直感的で使いやすく、バグを減らせる仕組みになっています。システム開発やWebアプリケーションでは、このパッケージを使うのが標準となっています。

2. LocalDateTimeクラスの概要

2. LocalDateTimeクラスの概要
2. LocalDateTimeクラスの概要

LocalDateTimeは日付と時刻を同時に扱うクラスです。タイムゾーンの情報は持たないため、純粋に年月日と時刻を表現するのに適しています。現在日時を取得したり、演算で変更したり、柔軟に使えます。

3. withメソッドとは?

3. withメソッドとは?
3. withメソッドとは?

withメソッドは、日時の一部を指定して変更できるメソッドです。例えば年だけを変更したり、月だけを変更したりといった操作が簡単にできます。元のインスタンスを変更せず、新しいLocalDateTimeオブジェクトを返すのも特徴です。

4. withメソッドの基本構文

4. withメソッドの基本構文
4. withメソッドの基本構文

基本的な構文は以下の通りです。


LocalDateTime 変更後 = 元の日時.with(ChronoField, 値);

また、特定の専用メソッド(withYearやwithMonthなど)も用意されています。

5. 年を変更する例

5. 年を変更する例
5. 年を変更する例

次の例では、年だけを変更しています。


import java.time.LocalDateTime;

public class WithYearExample {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.of(2023, 5, 10, 14, 30);
        LocalDateTime changed = dateTime.withYear(2025);

        System.out.println("元の日時: " + dateTime);
        System.out.println("変更後の日時: " + changed);
    }
}

元の日時: 2023-05-10T14:30
変更後の日時: 2025-05-10T14:30

6. 月を変更する例

6. 月を変更する例
6. 月を変更する例

次は月を変更する例です。


import java.time.LocalDateTime;

public class WithMonthExample {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.of(2024, 1, 20, 9, 0);
        LocalDateTime changed = dateTime.withMonth(12);

        System.out.println("元の日時: " + dateTime);
        System.out.println("変更後の日時: " + changed);
    }
}

元の日時: 2024-01-20T09:00
変更後の日時: 2024-12-20T09:00

7. 日を変更する例

7. 日を変更する例
7. 日を変更する例

日だけを変更する場合の例です。


import java.time.LocalDateTime;

public class WithDayExample {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.of(2025, 2, 5, 18, 45);
        LocalDateTime changed = dateTime.withDayOfMonth(28);

        System.out.println("元の日時: " + dateTime);
        System.out.println("変更後の日時: " + changed);
    }
}

元の日時: 2025-02-05T18:45
変更後の日時: 2025-02-28T18:45

8. 時刻を変更する例

8. 時刻を変更する例
8. 時刻を変更する例

時刻を変更する例も見てみましょう。


import java.time.LocalDateTime;

public class WithHourExample {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.of(2025, 7, 15, 10, 0);
        LocalDateTime changed = dateTime.withHour(22);

        System.out.println("元の日時: " + dateTime);
        System.out.println("変更後の日時: " + changed);
    }
}

元の日時: 2025-07-15T10:00
変更後の日時: 2025-07-15T22:00

9. withとplus/minusの違い

9. withとplus/minusの違い
9. withとplus/minusの違い

withは指定した値に直接置き換えるのに対して、plusやminusは相対的に加算や減算を行います。例えば「3月に変更したい」ならwithMonthを使い、「3か月後にしたい」ならplusMonthsを使うという違いがあります。

10. 実務での活用シーン

10. 実務での活用シーン
10. 実務での活用シーン

withメソッドは、システム開発における日付操作で頻繁に使われます。例えば、毎月の請求書作成で日付を指定した日付に変更する処理や、スケジュール管理アプリで特定の日や時刻を設定する場面などが代表例です。初心者でも理解しやすく、応用範囲も広いメソッドといえます。

まとめ

まとめ
まとめ

JavaのLocalDateTimeクラスに用意されているwithメソッドは、日時の一部だけを指定した値に変更したいときに便利なメソッドです。Javaで日付や時刻を扱う場合、年月日や時分秒をすべて作り直すのではなく、年だけ、月だけ、日だけ、時間だけを変更したい場面がよくあります。そのようなときにwithYear、withMonth、withDayOfMonth、withHourなどを使うと、読みやすく分かりやすいJavaプログラムを書くことができます。

LocalDateTimeはjava.timeパッケージに含まれる日時クラスで、日付と時刻を同時に扱えます。従来のDateやCalendarよりも直感的に操作できるため、現在のJava開発では標準的に使われています。特にSpring BootなどのWebアプリケーション開発でも、登録日時、更新日時、予約日時、開始日時、終了日時、締切日時などを扱う場面でLocalDateTimeはよく登場します。

withメソッドの大きな特徴は、元のLocalDateTimeオブジェクトを直接変更しないことです。LocalDateTimeは不変オブジェクトのため、withYearやwithMonthを呼び出しても元の日時は変わらず、変更後の新しいLocalDateTimeが返されます。そのため、変更後の値を使いたい場合は、戻り値を新しい変数に代入する必要があります。

withメソッドの基本をもう一度確認

withメソッドは、日時の一部を指定した値へ置き換えるために使います。たとえば、二千二十四年一月十日十時三十分という日時があり、年だけを二千二十六年に変えたい場合はwithYearを使います。月だけを変更したい場合はwithMonth、日だけを変更したい場合はwithDayOfMonth、時間だけを変更したい場合はwithHourを使います。


import java.time.LocalDateTime;

public class LocalDateTimeWithSummary {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.of(2024, 1, 10, 10, 30);

        LocalDateTime changedYear = dateTime.withYear(2026);
        LocalDateTime changedMonth = dateTime.withMonth(12);
        LocalDateTime changedDay = dateTime.withDayOfMonth(25);
        LocalDateTime changedHour = dateTime.withHour(18);

        System.out.println("元の日時: " + dateTime);
        System.out.println("年を変更: " + changedYear);
        System.out.println("月を変更: " + changedMonth);
        System.out.println("日を変更: " + changedDay);
        System.out.println("時を変更: " + changedHour);
    }
}

元の日時: 2024-01-10T10:30
年を変更: 2026-01-10T10:30
月を変更: 2024-12-10T10:30
日を変更: 2024-01-25T10:30
時を変更: 2024-01-10T18:30

このサンプルを見ると、withメソッドは指定した部分だけを変更し、他の年月日や時刻はそのまま残していることが分かります。年を変えても月や日は変わらず、時間を変えても日付は変わりません。Javaの日時操作では、このように必要な部分だけを変更できることが非常に便利です。

withとplusやminusの違い

LocalDateTimeにはwithのほかに、plusYears、plusMonths、plusDays、minusDaysなどのメソッドもあります。初心者が混同しやすいポイントですが、withは指定した値に置き換える処理で、plusやminusは現在の日時から加算または減算する処理です。

たとえば、月を三月にしたい場合はwithMonthを使います。一方で、現在の日時から三か月後にしたい場合はplusMonthsを使います。どちらも月に関する操作ですが、意味は大きく違います。


import java.time.LocalDateTime;

public class WithAndPlusExample {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.of(2025, 5, 10, 9, 0);

        LocalDateTime withMonth = dateTime.withMonth(3);
        LocalDateTime plusMonths = dateTime.plusMonths(3);

        System.out.println("元の日時: " + dateTime);
        System.out.println("三月に変更: " + withMonth);
        System.out.println("三か月後: " + plusMonths);
    }
}

元の日時: 2025-05-10T09:00
三月に変更: 2025-03-10T09:00
三か月後: 2025-08-10T09:00

このように、withMonthは月を三に置き換えていますが、plusMonthsは五月から三か月後の八月に進めています。日付操作では、置き換えたいのか、加算したいのかを考えてメソッドを選ぶことが大切です。

実務で使いやすい日時変更の考え方

JavaのLocalDateTimeとwithメソッドは、業務システムでもよく使われます。たとえば、予約システムで予約日だけを変更したい場合、請求システムで毎月の締め日を設定したい場合、勤怠管理システムで出勤時刻や退勤時刻を補正したい場合などです。日時の一部だけを変更できるため、処理の意図をコードから読み取りやすくなります。

たとえば、毎月二十五日の十時に請求処理を行う日時を作りたい場合、現在日時を基準にして日と時刻だけを変更することができます。


import java.time.LocalDateTime;

public class BillingDateExample {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.of(2025, 6, 3, 14, 20);

        LocalDateTime billingDate = now
                .withDayOfMonth(25)
                .withHour(10)
                .withMinute(0)
                .withSecond(0)
                .withNano(0);

        System.out.println("現在日時: " + now);
        System.out.println("請求日時: " + billingDate);
    }
}

現在日時: 2025-06-03T14:20
請求日時: 2025-06-25T10:00

このようにwithメソッドをつなげて使うことで、日付や時刻の複数の要素を順番に変更できます。メソッドチェーンとして書けるため、どの部分を変更しているのかが分かりやすくなります。

withメソッドを使うときの注意点

withメソッドを使うときは、指定する値が有効な範囲である必要があります。たとえばwithMonthに十三を指定したり、withDayOfMonthに存在しない日付を指定したりすると、例外が発生します。二月三十日や四月三十一日のように、実際には存在しない日付を作ろうとするとエラーになります。

日付を変更するときは、対象の年月にその日が存在するかを意識することが大切です。特に月末日を扱う処理や、うるう年が関係する二月の処理では注意が必要です。JavaのLocalDateTimeは不正な日時を作れないようになっているため、安全な日時処理につながりますが、入力値のチェックは必要です。

また、LocalDateTimeはタイムゾーンを持たない日時クラスです。日本時間や世界標準時などのタイムゾーンを意識する必要がある場合は、ZonedDateTimeやOffsetDateTimeなどの利用も検討します。ただし、一般的な業務システムで年月日と時刻だけを扱う場合は、LocalDateTimeで十分なケースも多くあります。

Java、LocalDateTime、java.time、withメソッド、withYear、withMonth、withDayOfMonth、withHour、日時変更、日付操作、時刻操作、plusメソッド、minusメソッド、不変オブジェクト、日付計算、予約日時、請求日時、登録日時、更新日時といったキーワードは、Javaの日時処理を学ぶうえで重要です。これらを関連づけて理解することで、実務でも使える日付操作の知識が身につきます。

初心者のうちは、日時処理は難しく感じることがあります。しかし、LocalDateTimeの基本を押さえ、withは置き換え、plusは加算、minusは減算という違いを理解すれば、日時操作の考え方は整理しやすくなります。特にwithメソッドは、指定した年月日や時刻へ変更する処理を書くときに便利なので、実際のサンプルコードを何度も動かして覚えるのがおすすめです。

今回学んだwithメソッドは、単に日時を変更するためだけの機能ではありません。読みやすく、意図が伝わりやすいJavaコードを書くためにも役立ちます。日時を直接作り直すよりも、元の日時から必要な部分だけを変更することで、プログラムの目的が分かりやすくなります。Javaの日時操作をしっかり理解して、予約管理、スケジュール管理、請求処理、ログ記録など、さまざまな開発に活用していきましょう。

先生と生徒の振り返り会話

生徒

LocalDateTimeのwithメソッドは、日時の一部だけを変更するときに使うことが分かりました。

先生

その通りです。年だけ、月だけ、日だけ、時間だけを指定した値に置き換えたいときに便利です。

生徒

withYearやwithMonth、withDayOfMonth、withHourを使えば、目的に合わせて日時を変更できるのですね。

先生

はい。メソッド名から何を変更しているのか分かりやすいので、読みやすいJavaコードになります。

生徒

withメソッドを使っても、元のLocalDateTimeは変わらないという点も大切ですね。

先生

はい。LocalDateTimeは不変オブジェクトなので、変更後の値を使うには戻り値を変数に入れる必要があります。

生徒

withは置き換えで、plusやminusは加算や減算という違いも整理できました。

先生

その理解で大丈夫です。三月にしたいならwithMonth、三か月後にしたいならplusMonthsというように使い分けます。

生徒

実務では、請求日時や予約日時、締切日時などを作るときに使えそうです。

先生

はい。特定の日や時刻に変更する処理は、業務システムでもよくあります。withメソッドを使うと処理の意図が分かりやすくなります。

生徒

ただし、存在しない日付を指定すると例外になるので、日付の範囲には注意が必要ですね。

先生

その通りです。二月三十日や十三月などは作れません。入力値を確認しながら、安全に日時処理を書くことが大切です。

生徒

LocalDateTimeとwithメソッドを理解すると、Javaの日付操作がかなり書きやすくなりそうです。

先生

はい。日時処理は多くのシステムで必要になります。withメソッド、plusメソッド、minusメソッドの違いを意識しながら、実践的なJavaプログラムに活用していきましょう。

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

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

AIスキルアカデミーの口コミ・評判を詳しく見る
カテゴリの一覧へ
新着記事
New1
Spring
Spring Data JPAのJpaRepositoryインターフェースの使い方を完全ガイド!初心者でも安心
更新記事
New2
Java
JavaのVectorクラスの使い方を完全ガイド!初心者でもわかるコレクションの基本
更新記事
New3
JSP
JSPのEL式で論理演算を行う方法を完全解説 初心者でもわかるAND OR NOTの使い方と条件分岐
新規投稿
New4
Java
JavaのHashMapクラスを完全ガイド!初心者でもわかる連想配列の使い方
更新記事
人気記事
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リクエストの仕組みと使い方を初心者向けに徹底解説