DateTimeFormatter.WithChronology(IChronology) 方法

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);

[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

參數

傳回

基於此格式化器並要求覆蓋時間順序的格式化器，而非空格式

屬性

RegisterAttribute

備註

回傳一份帶有新覆蓋時間順序的格式化器副本。

此時會回傳一個與該格式化器狀態相似但覆蓋時間順序的格式器。 預設情況下，格式化器沒有覆寫時間順序，回傳為空。

若新增覆寫，任何格式化或解析過的日期都會受到影響。

格式化時，若時間物件包含日期，則會將其轉換為覆蓋時間序列中的日期。 時間軸是否包含日期則透過查詢 ChronoField#EPOCH_DAY EPOCH_DAY 欄位來判斷。 任何時間或時區都會保留不變，除非被覆蓋。

若時序物件不包含日期，但包含一個或多個 ChronoField 日期欄位，則拋出 a DateTimeException 。 在其他情況下，覆寫時間順序會被加入時間軸，取代先前的順序，但日期/時間不變。

在解析時，有兩種不同的情況需要考慮。 如果時間順序是直接從文本解析而來，例如因為 DateTimeFormatterBuilder#appendChronologyId() 使用了 ，那麼這個覆寫的時間順序就沒有影響。 若未解析任何區域，則此覆寫時間順序將依照時間軸的日期解析規則將數值解讀 ChronoField 成日期。

此實例是不可變且不受此方法呼叫影響的。

Java 文件 java.time.format.DateTimeFormatter.withChronology(java.time.chrono.Chronology)。

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