Instant.With 方法

定義

命名空間:

Java.Time

組件:

Mono.Android.dll

多載

名稱	Description
With(ITemporalField, Int64)	回傳此即時的副本，並將指定欄位設定為新值。
With(ITemporalAdjuster)	回傳此即時的修正後副本。

With(ITemporalField, Int64)

回傳此即時的副本，並將指定欄位設定為新值。

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/Instant;", "", 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/Instant;", "", 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

TemporalField：結果中要設定的欄位，非 null

newValue

Int64

長值：結果中場的新值

傳回

ITemporal

基於此的即時運算，並設定指定欄位，而非空

實作

With(ITemporalField, Int64)

屬性

RegisterAttribute

備註

回傳此即時的副本，並將指定欄位設定為新值。 此時會回傳一個即時的 Instant，且指定欄位的值已改變。 若無法設定該值，例如該欄位不被支援或其他原因，則會拋出例外。 如果欄位是時間場，調整會在這裡實作。 所支援的欄位行為如下：NANO_OF_SECOND - 回傳一個以指定奈米秒數的瞬間。 紀元二將保持不變。 MICRO_OF_SECOND - 回傳一個瞬間，將奈米秒換成指定的微秒乘以1,000。 紀元二將保持不變。 MILLI_OF_SECOND - 回傳一個瞬間，奈米秒被指定的毫秒乘以1,000,000。 紀元二將保持不變。 INSTANT_SECONDS - 回傳一個以指定紀秒為值的瞬間。 秒的奈米級將保持不變。 無論哪種情況，如果新值超出該欄位的有效值範圍，就會拋出 DateTimeException。 其他所有 ChronoField 實例都會拋出 UnsupportedTemporalTypeException。 若欄位不是 ChronoField，則透過呼叫 TemporalField.adjustInto（Temporal， long） 並傳遞參數，取得此方法的結果。 在這種情況下，場決定是否以及如何調整瞬間。 此實例是不可變且不受此方法呼叫影響的。

拋出：數值溢位發生時的 ArithmeticException

Throws： DateTimeException 如果欄位無法設定

拋出：UnsupportedTemporalTypeException 若欄位未被支援

Android 參考資料。java.time.Instant.with

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

With(ITemporalAdjuster)

回傳此即時的修正後副本。

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/Instant;", "", ApiSince=26)]
public Java.Time.Instant? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);

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

參數

adjuster

ITemporalAdjuster

TemporalAdjuster：要用的調整器，不是 null

傳回

Instant

基於此調整的瞬間，而非空

屬性

RegisterAttribute

備註

回傳此即時的修正後副本。 這會根據這個回傳一個瞬間，並調整過瞬間。 調整是使用指定的調整策略物件進行的。 閱讀理算師的文件，了解會做哪些調整。 此方法的結果是透過在指定的調整器上呼叫 TemporalAdjuster.adjustInto（Temporal） 方法，將此方法作為參數來取得。 此實例是不可變且不受此方法呼叫影響的。

拋出：數值溢位發生時的 ArithmeticException

擲出次數：若無法調整，則使用DateTimeException

Android 參考資料。java.time.Instant.with

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。