美容の予約

日付と時刻

Java 8で導入されたjava.timeパッケージには、日付と時刻を扱うためのいくつかのクラスが含まれています。

LocalDate

java.time.LocalDateクラスは、ISO-8601の暦体系における、タイムゾーンのない日付を表します。たとえば2007-12-03のようなものです。

LocalDate date = LocalDate.of(2007, 12, 3);

日付はほかの日付と比較できます。

LocalDate date1 = LocalDate.of(2007, 12, 3);
LocalDate date2 = LocalDate.of(2007, 12, 4);

date1.isBefore(date2);
// => true

date1.isAfter(date2);
// => false

LocalDateのインスタンスには、日付の各部分を取り出すためのゲッターがあります。

LocalDate date = LocalDate.of(2007, 12, 3);

date.getDayOfMonth();
// => 3

LocalDateのインスタンスには、時間の単位を加えるためのメソッドがあります。

LocalDate date = LocalDate.of(2007, 12, 3);

date.plusDays(3);
// => 2007-12-06

LocalDateTime

java.time.LocalDateTimeクラスは、ISO-8601の暦体系における、タイムゾーンのない日時を表します。たとえば2007-12-03T10:15:30のようなものです。

LocalDateTime datetime = LocalDateTime.of(2007, 12, 3, 10, 15, 30);

LocalDateのインスタンスは、LocalDateTimeに変換できます。

LocalDate date = LocalDate.of(2007, 12, 3);
LocalDateTime datetime = date.atTime(10, 15, 30);
datetime.toString();
// => "2007-12-03T10:15:30"

日時のフォーマット

LocalDateとLocalDateTimeはどちらも、Stringとの相互変換にISO-8601の標準表記を使います。

LocalDateTime datetime = LocalDateTime.of(2007, 12, 3, 10, 15, 30);
LocalDateTime parsed = LocalDateTime.parse("2007-12-03T10:15:30");

datetime.isEqual(parsed);
// => true

このように、異なるフォーマットを使ってStringからLocalDateやLocalDateTimeをパースすることはできません。 代わりに、独自のフォーマットで日付をフォーマットするには、java.time.format.DateTimeFormatterを使います。

DateTimeFormatter parser = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate date = LocalDate.parse("03/12/2007", parser);

DateTimeFormatter printer = DateTimeFormatter.ofPattern("MMMM d, yyyy");
printer.format(date);
// => "December 3, 2007"

独自のフォーマットを作成するときにロケールを指定すれば、地域に合わせたフォーマットやパースもできます。

DateTimeFormatter.ofPattern("MMMM d, yyyy", Locale.FRENCH).format(date);
// => décembre 3, 2007

DateTimeFormatter.ofPattern("MMMM d, yyyy", Locale.of("pt")).format(date);
// => dezembro 3, 2007