DateTimeFormatter.WithZone(ZoneId) 方法

定義

命名空間:

Java.Time.Format

組件:

Mono.Android.dll

傳回具有新覆寫區域的這個格式子複本。

[Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithZone (Java.Time.ZoneId? zone);

[<Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithZone : Java.Time.ZoneId -> Java.Time.Format.DateTimeFormatter

參數

zone

ZoneId

新的覆寫區域，如果沒有覆寫則為 Null

傳回

DateTimeFormatter

以這個格式子為基礎的格式器，具有要求的覆寫區域，而不是 Null

屬性

RegisterAttribute

備註

傳回具有新覆寫區域的這個格式子複本。

這會傳回格式器，其狀態與這個格式器類似，但已設定覆寫區域。 根據預設，格式器沒有覆寫區域，會傳回 null。

如果已新增覆寫，則會影響格式化或剖析的任何瞬間。

格式化時，如果時態物件包含瞬間，則會使用覆寫區域將它轉換成分區日期時間。 時態性是否為瞬間，由查詢 ChronoField#INSTANT_SECONDS INSTANT_SECONDS 欄位來決定。 如果輸入具有時序表，除非覆寫，否則會保留它。 如果輸入沒有計時表，例如 Instant，則會使用 ISO 時序表。

如果時態物件不包含瞬間，但包含位移，則會進行額外的檢查。 如果標準化覆寫區域是與時態性位移不同的位移，則會 DateTimeException 擲回 。 在其他所有情況下，覆寫區域都會新增至時態，取代任何先前的區域，但不會變更日期/時間。

剖析時，有兩個不同的案例需要考慮。 如果區域已直接從文字剖析，也許是因為 DateTimeFormatterBuilder#appendZoneId() 已使用，則此覆寫區域沒有作用。 如果未剖析任何區域，則此覆寫區域將會包含在剖析的結果中，以便用來建置立即和日期時間。

這個實例不可變且不受此方法呼叫影響。

的 java.time.format.DateTimeFormatter.withZone(java.time.ZoneId)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。