LocalDate.Plus 方法

[Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/LocalDate;", "", ApiSince=26)]
public Java.Time.LocalDate? Plus(Java.Time.Temporal.ITemporalAmount? amountToAdd);

[<Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/LocalDate;", "", ApiSince=26)>]
member this.Plus : Java.Time.Temporal.ITemporalAmount -> Java.Time.LocalDate

參數

傳回

基於此日期並加了新增內容的 LocalDate，而非空

屬性

RegisterAttribute

備註

回傳一份日期副本，並加上指定的金額。 這會回傳一個基於此日期的 LocalDate，並加上指定的金額。 金額通常是 Period，但也可能是其他實作 TemporalAmount 介面的類型。 計算會透過呼叫 TemporalAmount.addTo（Temporal） 委派給 amount 物件。 金額實作可以自由實現加法，但通常會回調 plus（long， TemporalUnit）。 請查閱金額實施的文件，判斷是否能成功新增。 此實例是不可變且不受此方法呼叫影響的。

Java 參考 java.time.LocalDate.plus。

[Android.Runtime.Register("plus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/LocalDate;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? Plus(long amountToAdd, Java.Time.Temporal.ITemporalUnit? unit);

[<Android.Runtime.Register("plus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/LocalDate;", "", ApiSince=26)>]
abstract member Plus : int64 * Java.Time.Temporal.ITemporalUnit -> Java.Time.Temporal.ITemporal
override this.Plus : int64 * Java.Time.Temporal.ITemporalUnit -> Java.Time.Temporal.ITemporal

參數

傳回

一個以該日期為基礎的 LocalDate，並加上指定金額，而非空

實作

屬性

RegisterAttribute

備註

回傳一份日期副本，並加上指定的金額。 這會回傳一個基於此的 LocalDate，金額是以單位為單位計算。 若無法新增金額，例如該單位不支援或其他原因，則會拋出例外。 有時加上金額會導致該日期失效。 例如，將一個月加到1月31日，結果就是2月31日。 在這種情況下，單位負責解決日期。 通常會選擇先前的有效日期，也就是這個例子中二月的最後有效日期。 如果場是 ChronoUnit，則此處實作加法。 支援欄位的行為如下：DAYS - 回傳一個已加入指定天數的 LocalDate。 這相當於 plusDays（long）。 WEEKS - 回傳一個 LocalDate，並加上指定的週數。 這相當於 plusWeeks（long），並採用 7 天工作週。 MONTHS - 回傳一個 LocalDate，並新增指定月份數。 這相當於 plusMonths（long）。 這個月的日期將保持不變，除非新月份和新年會失效。 此時，月日會調整為新月及新年度的最大有效值。 YEARS - 回傳一個已加入指定年數的 LocalDate。 這相當於 plusYears（long）。 這個月的日期將保持不變，除非新月份和新年會失效。 此時，月日會調整為新月及新年度的最大有效值。 DECADES - 回傳一個 LocalDate，並加上指定的十年數。 這相當於呼叫 plusYears（long），但金額乘以 10。 這個月的日期將保持不變，除非新月份和新年會失效。 此時，月日會調整為新月及新年度的最大有效值。 CENTURIES - 回傳一個 LocalDate，並加上指定的世紀數。 這相當於打電話給 plusYears（long），金額乘以 100。 這個月的日期將保持不變，除非新月份和新年會失效。 此時，月日會調整為新月及新年度的最大有效值。 MILLENNIA - 回傳一個 LocalDate，並加上指定的千年年數。 這相當於撥打 plusYears（long） 並將金額乘以 1,000。 這個月的日期將保持不變，除非新月份和新年會失效。 此時，月日會調整為新月及新年度的最大有效值。 ERAS - 回傳一個已加入指定數量 ERAS 的 LocalDate。 僅支援兩個時代，因此數量必須是一、零或負一。 若金額非零，則年份會變動，使得該年不變。 這個月的日期將保持不變，除非新月份和新年會失效。 此時，月日會調整為新月及新年度的最大有效值。 所有其他 ChronoUnit 實例都會拋出 UnsupportedTemporalTypeException。 若欄位不是 ChronoUnit，則透過呼叫 TemporalUnit.addTo（Temporal， long）並將此參數傳遞為參數，得出此方法的結果。 在這種情況下，單位決定是否以及如何進行加法。 此實例是不可變且不受此方法呼叫影響的。

Java 參考 java.time.LocalDate.plus。