语言

LocalDate.With 方法

定义

重载

名称 说明
With(ITemporalAdjuster)

返回此日期的调整副本。

With(ITemporalField, Int64)

返回此日期的副本,并将指定的字段设置为新值。

With(ITemporalAdjuster)

返回此日期的调整副本。

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/LocalDate;", "", ApiSince=26)]
public Java.Time.LocalDate? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/LocalDate;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.LocalDate

参数

adjuster
ITemporalAdjuster

要使用的调整器,而不是 null

返回

基于此的 LocalDate,其中进行了调整,而不是 null

特性

注解

返回此日期的调整副本。 这会根据此日期返回 LocalDate,并调整日期。 调整是使用指定的调整器策略对象进行的。 阅读调整器的文档,了解将进行哪些调整。 简单的调整器可能只是设置其中一个字段,例如年份字段。 更复杂的调整器可能会将日期设置为月份的最后一天。 在 TemporalAdjusters 中提供了一系列常见调整。 其中包括查找“本月的最后一天”和“下周三”。 关键日期时间类还实现 TemporalAdjuster 接口,例如 Month 和 MonthDay。 调整器负责处理特殊情况,例如月和跃年的不同长度。 例如,此代码返回 7 月最后一天的日期:

import static java.time.Month.*;
import static java.time.temporal.TemporalAdjusters.*;

result = localDate.with(JULY).with(lastDayOfMonth());

此方法的结果是通过调用指定调整器上的 TemporalAdjuster.adjustInto(Temporal) 方法作为参数传递此方法来获取的。 此实例不可变,不受此方法调用影响。

Java参考java.time.LocalDate.with。

适用于

With(ITemporalField, Int64)

返回此日期的副本,并将指定的字段设置为新值。

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/LocalDate;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/LocalDate;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal

参数

field
ITemporalField

在结果中设置的字段,而不是 null

newValue
Int64

结果中字段的新值

返回

基于具有指定字段集的 LocalDate,而不是 null

实现

特性

注解

返回此日期的副本,并将指定的字段设置为新值。 这将基于此返回 LocalDate,并更改了指定字段的值。 这可用于更改任何受支持的字段,例如年、月或月。 如果无法设置值,因为该字段不受支持或出于其他原因,则会引发异常。 在某些情况下,更改指定的字段可能会导致生成的日期变得无效,例如将月份从 1 月 31 日到 2 月的更改会使月份无效。 在这种情况下,字段负责解决日期。 通常,它将选择上一个有效日期,这将是此示例中 2 月的最后一个有效日期。 如果该字段是 ChronoField,则在此处实现调整。 支持的字段的行为如下:DAY_OF_WEEK - 返回具有指定星期几的 LocalDate。 日期在星期一至星期日周的边界内向前或向后调整为 6 天:ALIGNED_DAY_OF_WEEK_IN_MONTH - 返回具有指定一周对齐日期的 LocalDate。 日期调整为指定的基于月份的一周对齐日期。 对齐的周数统计为给定月份的第一周从当月的第一天开始。 这可能导致日期在以下月份中最多移动 6 天:ALIGNED_DAY_OF_WEEK_IN_YEAR - 返回具有指定一周对齐日期的 LocalDate。 日期调整为指定的基于年份的一周对齐日期。 对齐的周数统计为给定年份的第一周从当年的第一天开始。 这可能导致日期在次年移动到最多 6 天:DAY_OF_MONTH - 返回具有指定月份日期的 LocalDate。 月份和年份将保持不变。 如果当年和月份的日数无效,则会引发 DateTimeException;DAY_OF_YEAR - 返回具有指定年份日期的 LocalDate。 年份将保持不变。 如果年份的一天无效,则会引发 DateTimeException;EPOCH_DAY - 返回具有指定纪元日期的 LocalDate。 这完全取代了日期,相当于EpochDay(long):ALIGNED_WEEK_OF_MONTH - 返回具有指定一周的 LocalDate。 对齐的周数统计为给定月份的第一周从当月的第一天开始。 此调整将整个星期区块中的日期移动到与指定周匹配。 结果将具有与此日期相同的一周。 这可能会导致日期移动到下个月;ALIGNED_WEEK_OF_YEAR - 返回具有指定一周的 LocalDate。 对齐的周数统计为给定年份的第一周从当年的第一天开始。 此调整将整个星期区块中的日期移动到与指定周匹配。 结果将具有与此日期相同的一周。 这可能会导致日期移动到第二年:MONTH_OF_YEAR - 返回具有指定年月的 LocalDate。 年份将保持不变。 除非新月和年份无效,否则一个月的日期也将保持不变。 在这种情况下,月数调整为新月和年份的最大有效值;PROLEPTIC_MONTH - 返回具有指定 proleptic-month 的 LocalDate。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,月数调整为新月和年份的最大有效值;YEAR_OF_ERA - 返回具有指定年份的 LocalDate。 时代和月份将保持不变。 除非新月和年份无效,否则一个月的日期也将保持不变。 在这种情况下,月数调整为新月和年份的最大有效值;YEAR - 返回具有指定年份的 LocalDate。 月份将保持不变。 除非新月和年份无效,否则一个月的日期也将保持不变。 在这种情况下,月数调整为新月和年份的最大有效值;ERA - 返回具有指定纪元的 LocalDate。 时代和月份将保持不变。 除非新月和年份无效,否则一个月的日期也将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 在所有情况下,如果新值超出字段的有效值范围,则将引发 DateTimeException。 所有其他 ChronoField 实例都将引发 UnsupportedTemporalTypeException。 如果字段不是 ChronoField,则通过调用 TemporalField.adjustInto(Temporal, long)作为参数来获取此方法的结果。 在这种情况下,字段确定是否以及如何调整即时。 此实例不可变,不受此方法调用影响。

Java参考java.time.LocalDate.with。

适用于