Java : Temporal - API使用例

final Temporal temporal = LocalDate.of(2100, 4, 10);
System.out.println(temporal); // 2100-04-10

final var ret1 = temporal.plus(Period.ofDays(5));
System.out.println(ret1); // 2100-04-15

final var ret2 = temporal.minus(Period.ofYears(101));
System.out.println(ret2); // 1999-04-10

final Temporal temporal = LocalTime.of(16, 59);
System.out.println(temporal); // 16:59

final var ret1 = temporal.plus(Duration.ofMinutes(1));
System.out.println(ret1); // 17:00

final var ret2 = temporal.minus(Duration.ofHours(10));
System.out.println(ret2); // 06:59

boolean isSupported (TemporalUnit unit)

指定された単位がサポートされているかどうかをチェックします。

final Temporal temporal = LocalDate.of(2100, 4, 15);
System.out.println(temporal); // 2100-04-15

System.out.println(temporal.isSupported(ChronoField.YEAR)); // true
System.out.println(temporal.isSupported(ChronoField.MONTH_OF_YEAR)); // true
System.out.println(temporal.isSupported(ChronoField.DAY_OF_MONTH)); // true

System.out.println(temporal.isSupported(ChronoField.HOUR_OF_DAY)); // false

final Temporal temporal = LocalTime.of(16, 30, 59);
System.out.println(temporal); // 16:30:59

System.out.println(temporal.isSupported(ChronoField.HOUR_OF_DAY)); // true
System.out.println(temporal.isSupported(ChronoField.MINUTE_OF_HOUR)); // true
System.out.println(temporal.isSupported(ChronoField.SECOND_OF_MINUTE)); // true

System.out.println(temporal.isSupported(ChronoField.YEAR)); // false

default Temporal minus (long amountToSubtract, TemporalUnit unit)

指定された期間を減算して、このオブジェクトと同じ型のオブジェクトを返します。

final Temporal temporal = LocalDate.of(2100, 4, 10);
System.out.println(temporal); // 2100-04-10

final var ret1 = temporal.plus(5, ChronoUnit.DAYS);
System.out.println(ret1); // 2100-04-15

final var ret2 = temporal.minus(101, ChronoUnit.YEARS);
System.out.println(ret2); // 1999-04-10

final Temporal temporal = LocalTime.of(16, 59);
System.out.println(temporal); // 16:59

final var ret1 = temporal.plus(1, ChronoUnit.MINUTES);
System.out.println(ret1); // 17:00

final var ret2 = temporal.minus(10, ChronoUnit.HOURS);
System.out.println(ret2); // 06:59

default Temporal minus (TemporalAmount amount)

量を減算して、このオブジェクトと同じ型のオブジェクトを返します。

final Temporal temporal = LocalDate.of(2100, 4, 10);
System.out.println(temporal); // 2100-04-10

final var ret1 = temporal.plus(Period.ofDays(5));
System.out.println(ret1); // 2100-04-15

final var ret2 = temporal.minus(Period.ofYears(101));
System.out.println(ret2); // 1999-04-10

final Temporal temporal = LocalTime.of(16, 59);
System.out.println(temporal); // 16:59

final var ret1 = temporal.plus(Duration.ofMinutes(1));
System.out.println(ret1); // 17:00

final var ret2 = temporal.minus(Duration.ofHours(10));
System.out.println(ret2); // 06:59

Temporal plus (long amountToAdd, TemporalUnit unit)

このオブジェクトと同じ型のオブジェクトに指定された期間を追加したものを返します。

このメソッドの使用例は、minus(long amountToSubtract, TemporalUnit unit) にまとめて記載しました。
そちらのAPI使用例をご参照ください。

default Temporal plus (TemporalAmount amount)

このオブジェクトと同じ型のオブジェクトにある時間を追加したものを返します。

このメソッドの使用例は、minus(TemporalAmount amount) にまとめて記載しました。
そちらのAPI使用例をご参照ください。

long until (Temporal endExclusive, TemporalUnit unit)

別のtemporalまでの時間量を指定された単位で計算します。

final Temporal temporal1 = LocalTime.of(8, 0);
final Temporal temporal2 = LocalTime.of(10, 30);

System.out.println(temporal1); // 08:00
System.out.println(temporal2); // 10:30

System.out.println(temporal1.until(temporal2, ChronoUnit.HOURS)); // 2
System.out.println(temporal1.until(temporal2, ChronoUnit.MINUTES)); // 150

System.out.println(temporal2.until(temporal1, ChronoUnit.HOURS)); // -2
System.out.println(temporal2.until(temporal1, ChronoUnit.MINUTES)); // -150

default Temporal with (TemporalAdjuster adjuster)

調整を行って、このオブジェクトと同じ型の調整済のオブジェクトを返します。

final Temporal temporal = LocalDate.of(2100, 4, 15);
System.out.println(temporal); // 2100-04-15

final var ret1 = temporal.with(Year.of(1999));
System.out.println(ret1); // 1999-04-15

final var ret2 = temporal.with(Month.JANUARY);
System.out.println(ret2); // 2100-01-15

final var ret3 = temporal.with(TemporalAdjusters.firstDayOfMonth());
System.out.println(ret3); // 2100-04-01

final var ret4 = temporal.with(TemporalAdjusters.lastDayOfMonth());
System.out.println(ret4); // 2100-04-30

Temporal with (TemporalField field, long newValue)

指定されたフィールドを変更して、このオブジェクトと同じ型のオブジェクトを返します。

final Temporal temporal = LocalDate.of(2100, 4, 15);
System.out.println(temporal); // 2100-04-15

final var ret1 = temporal.with(ChronoField.YEAR, 1999);
System.out.println(ret1); // 1999-04-15

final var ret2 = temporal.with(ChronoField.MONTH_OF_YEAR, 1);
System.out.println(ret2); // 2100-01-15

final var ret3 = temporal.with(ChronoField.DAY_OF_MONTH, 30);
System.out.println(ret3); // 2100-04-30

get, getLong, isSupported, query, range

「Java API 使用例 : TemporalAccessor」をご参照ください。