【Java】日付操作はjava.timeで！

2025年5月26日2025年7月4日

Javaで日付や時間を扱う場面は多く、システム開発では欠かせない要素の一つです。
しかし、かつての Date や Calendar は設計が古く、扱いづらさやバグの温床となることもしばしばありました。
こうした背景から、Java 8以降で登場したのが java.time パッケージです。

この記事では、この java.time がなぜ「今どきのJava開発に欠かせない」のか、その理由と使い方を、現場視点でわかりやすく解説します。

なぜ日時操作は難しいのか？

日付や時間の扱いは、一見シンプルに思えて実は非常に奥が深く、バグの温床になりやすい領域です。
現場で「なぜか日付が1日ずれる」「タイムゾーンの変換で混乱する」といった問題に遭遇したことはありませんか？

月末やうるう年など、カレンダーの特殊ルール
タイムゾーンやサマータイムの違い
日付の加算・減算時の予期せぬ結果
スレッドセーフでないAPIの使用による不具合

従来の java.util.Date や Calendar は、こうした複雑さをうまく扱えず、煩雑でエラーを生みやすいコードになりがちでした。
その反省を踏まえて、Java 8では java.time という強力で使いやすい日時APIが導入されました。

java.time パッケージとは？

java.time パッケージは、Java 8で導入された新しい日付と時間のAPIです。
従来の Date や Calendar の使いづらさを解消するために、Joda-Time の設計思想をベースに開発されました。

このパッケージは、現代のソフトウェア開発に必要な明確さ・安全性・柔軟性を兼ね備えており、以下のような特長があります。

不変（immutable）でスレッドセーフ：安全に並行処理が可能
直感的で分かりやすいクラス設計：誤解しにくいAPI
日付計算・フォーマットが簡単：実用的な操作が充実

代表的なクラスには次のようなものがあります。

クラス名	説明
`LocalDate`	年月日（時刻なし）
`LocalTime`	時刻（年月日なし）
`LocalDateTime`	年月日＋時刻（タイムゾーンなし）
`ZonedDateTime`	タイムゾーン付き日時
`Period`, `Duration`	日数や時間の差分
`DateTimeFormatter`	フォーマットやパース処理

なぜ java.time を使うべきか？

Java 8以前では Date や Calendar を使って日付・時間を操作していましたが、これらには多くの落とし穴があり、バグやメンテナンスのしづらさを招いていました。

🔴従来のAPIの課題

// 日付の指定が間違いやすい（例：2025/1/31 12:34）
Date date = new Date(125, 0, 31, 12, 34);

// 日時の変更も不明確
date.setYear(125); // 2025年を設定
date.setMonth(0);  // 1月を設定

APIが冗長で、正しく使うのが難しい
年が 1900 に加算した数を指定する必要がある（1900＋125＝2025年）
月が 0 始まりで直感に反する（0や12は1月を指す）
ミュータブル（可変）なため、マルチスレッドでは注意が必要

🟢 java.time の優れた点

// 日付の指定が間違いにくい（例：2025/1/31 12:34）
LocalDateTime date = LocalDateTime.of(2025, 1, 31, 12, 34);

// 日時の加算・減算も可能
LocalDateTime nextWeek = date.plusWeeks(1);

直感的なAPI設計：読みやすく、書きやすい
イミュータブル（不変）：日時操作時には新しいインスタンスを返却するため安全

実際の開発現場でも、java.time に移行したことでバグが減り、チーム内のコードが統一されやすくなったという声は多く聞かれます。保守性・品質の面でも大きなメリットがあります。

よく使うjava.timeのクラスと使い方

java.time パッケージには、用途ごとに適したクラスが用意されています。ここでは、実務で頻繁に使われる代表的なクラスとその使用例を紹介します。

`LocalDate`：日付（年月日）

「日付」だけを扱いたいときに使います。

LocalDate today = LocalDate.now();
LocalDate tomorrow = today.plusDays(1);

`LocalDateTime`：日時（日付＋時刻）

タイムゾーンを考慮しない「日時」を表す場合に使用します。

LocalDateTime now = LocalDateTime.now();
LocalDateTime meeting = now.plusHours(3);

`ZonedDateTime`：タイムゾーン付き日時（日付＋時刻）

タイムゾーンを考慮した「日時」を表す場合に使用します。

ZonedDateTime tokyoNow = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));

`Period` / `Duration`：差分の計算

Period は日付（年・月・日）の差を扱います。
Duration は時刻（時間・分・秒）の差を扱います。

Period period = Period.between(LocalDate.of(2024,1,1), LocalDate.of(2025,1,1));
Duration duration = Duration.between(LocalTime.of(9, 0), LocalTime.of(17, 0));

`DateTimeFormatter`：フォーマット・パース

文字列として日付を出力したり、文字列から日付を読み取ったりする際に使用します。

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd");
String formatted = LocalDate.now().format(formatter);
LocalDate parsed = LocalDate.parse("2025/05/21", formatter);

`Date`, `Calendar` からの移行方法

Java 8 以前では、日時操作に java.util.Date や java.util.Calendar を使用していました。しかし、これらは設計上の問題やスレッドセーフでない点など多くの課題があり、現在では非推奨の扱いとなっています。

ここでは、これらの旧APIから java.time への移行方法を具体的に解説します。

`Date` → `LocalDateTime`

Date は内部的にエポック（1970年1月1日UTC）からのミリ秒で管理されています。これを Instant 経由でLocalDateTimeへ変換できます。

Date date = new Date();
Instant instant = date.toInstant();
LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, ZoneId.systemDefault());

日付のみの場合はLocalDateへ、時刻のみの場合はLocalTimeへ変換しましょう。（LocalDateTimeと同様に各クラスのofInstantメソッドを呼ぶ）

`Calendar` → `ZonedDateTime`

Calendar は日時とタイムゾーンの両方を管理しています。Instant 経由でZonedDateTime へ変換するのが自然な移行先です。

Calendar calendar = Calendar.getInstance();
Instant instant = calendar.toInstant();
ZonedDateTime zonedDateTime = instant.atZone(calendar.getTimeZone().toZoneId());

ZonedDateTime への変換時にはCalendar で保持していたタイムゾーンを使用します。