ImmutableでスレッドセーフになったJavaの新しい日時APIの基礎知識：ここが大変だよJava 8 Date-Time API（1）（3/5 ページ）

日付および時刻を表すJava 8のクラス

　Date-Time APIでは私たちが一般的に認識している日付や時刻（年、月、日、時、分、秒、ナノ秒）の単位で扱うさまざまなクラスが用意されています。特に旧日時APIのjava.util.Dateクラスやjava.util.Calendarクラスとは違い、例えば、日付だけ扱いたい場合や時刻のみ扱いたい場合など、Date-Time APIではさまざまな用途に合ったクラスを用意しています。

　それでは、どのようなクラスが用意されているか見てみましょう。

DateTime（日時を表すクラス）

　java.timeパッケージに用意されている日付および時刻（年、月、日、時、分、秒、ナノ秒）を表すクラスは次のものになります。

LocalDateTime localDateTime = LocalDateTime.of(2010, Month.JANUARY, 1, 12, 10, 10, 10);
System.out.println("localDateTime=" + localDateTime);
 
ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, ZoneId.of("America/New_York"));
System.out.println("zonedDateTime=" + zonedDateTime);
 
OffsetDateTime offsetDateTime = OffsetDateTime.of(localDateTime, ZoneOffset.of("+04:00"));
System.out.println("offsetDateTime=" + offsetDateTime);

localDateTime=2010-01-01T12:10:10.000000010
zonedDateTime=2010-01-01T12:10:10.000000010-05:00[America/New_York]
offsetDateTime=2010-01-01T12:10:10.000000010+04:00

　また、これらのクラスは、お互い別のクラスに、ZoneIdやZoneOffsetを設定することにより、タイムゾーンや時差の情報を持ったZonedDateTimeクラスやOffsetDateTimeクラスに変換することが可能です。また、逆に自身の持つタイムゾーンや時差の情報を除くことにより、それらの情報を持たないクラスに変換することも可能です。

Date（年月日を表すクラス）

　java.timeパッケージに用意されている日付（年、月、日）を表すクラスは次のLocalDateのみになります。このクラスには時刻である時、分、秒、ナノ秒の要素は待っていません。

　また、日時を表す各DateTimeのクラスからLocalDateクラスを取得するためのメソッドが用意されています。

　逆にLocalDateから各DateTimeを生成する主なメソッドに次のものが用意されています。

Time（時刻を表すクラス）

　java.timeパッケージには時刻を表すクラスが用意されています。それらのクラスは時、分、秒、ナノ秒の情報を持っており、下記のクラスがあります。このクラスには日付の年、月、日の要素は待っていません。

その他の日付や曜日を表すクラスおよび列挙型

　java.timeパッケージには年月や月日および年を表すクラス、および月や曜日を表す列挙型が用意されています。

　この中でYearMonthやMonthDayクラスからLocalDateを生成するメソッドを持っています。そして、YearクラスにはLocalDateおよびYearMonthを生成するメソッドが用意されています。

　このようにYearMonth、MonthDay、YearクラスにはLocalDateを生成するメソッドが用意されています。しかし、各DateTimeクラスや各DateクラスからYearMonth、MonthDay、Yearを生成するメソッドは用意されていません。特に注意が必要なのはgetYearメソッドで、これはint値で結果を返します。

　また、月を表す列挙型のMonthを取得するメソッドが月の値を持つクラスに用意されていて、曜日を表すDayOfWeekを取得するメソッドは、曜日を算出するために必要な、年と月と日の値を持つクラスに用意されています。