程序包 java.time.temporal

接口 TemporalAdjuster

所有已知子接口:

ChronoLocalDate, ChronoLocalDateTime<D>, Era

所有已知实现类:

DayOfWeek, HijrahDate, HijrahEra, Instant, IsoEra, JapaneseDate, JapaneseEra, LocalDate, LocalDateTime, LocalTime, MinguoDate, MinguoEra, Month, MonthDay, OffsetDateTime, OffsetTime, ThaiBuddhistDate, ThaiBuddhistEra, Year, YearMonth, ZoneOffset

函数接口:

这是一个函数接口, 因此可用作 lambda 表达式或方法引用的赋值目标。

@FunctionalInterface
public interface TemporalAdjuster

Strategy for adjusting a temporal object.

Adjusters are a key tool for modifying temporal objects. They exist to externalize the process of adjustment, permitting different approaches, as per the strategy design pattern. Examples might be an adjuster that sets the date avoiding weekends, or one that sets the date to the last day of the month.

There are two equivalent ways of using a TemporalAdjuster. The first is to invoke the method on this interface directly. The second is to use Temporal#with(TemporalAdjuster):

   // these two lines are equivalent, but the second approach is recommended
   temporal = thisAdjuster.adjustInto(temporal);
   temporal = temporal.with(thisAdjuster);
 

It is recommended to use the second approach, with(TemporalAdjuster), as it is a lot clearer to read in code.

The TemporalAdjusters class contains a standard set of adjusters, available as static methods. These include:

• finding the first or last day of the month
• finding the first day of next month
• finding the first or last day of the year
• finding the first day of next year
• finding the first or last day-of-week within a month, such as "first Wednesday in June"
• finding the next or previous day-of-week, such as "next Thursday"

从以下版本开始:

1.8

另请参阅:

TemporalAdjusters

方法概要

限定符和类型	方法	说明
Temporal	adjustInto(Temporal temporal)	Adjusts the specified temporal object.

方法详细资料

adjustInto

Temporal adjustInto(Temporal temporal)

Adjusts the specified temporal object.

This adjusts the specified temporal object using the logic encapsulated in the implementing class. Examples might be an adjuster that sets the date avoiding weekends, or one that sets the date to the last day of the month.

There are two equivalent ways of using this method. The first is to invoke this method directly. The second is to use Temporal#with(TemporalAdjuster):

   // these two lines are equivalent, but the second approach is recommended
   temporal = thisAdjuster.adjustInto(temporal);
   temporal = temporal.with(thisAdjuster);
 

It is recommended to use the second approach, with(TemporalAdjuster), as it is a lot clearer to read in code.

参数:

temporal - the temporal object to adjust, not null

返回:

an object of the same observable type with the adjustment made, not null

抛出:

DateTimeException - if unable to make the adjustment

ArithmeticException - if numeric overflow occurs