LocalDateTime.AtZone(ZoneId) 方法

定義

命名空間:

Java.Time

組件:

Mono.Android.dll

將此日期時間與時區結合，建立 ZonedDateTime。

[Android.Runtime.Register("atZone", "(Ljava/time/ZoneId;)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.ZonedDateTime? AtZone(Java.Time.ZoneId? zone);

[<Android.Runtime.Register("atZone", "(Ljava/time/ZoneId;)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
member this.AtZone : Java.Time.ZoneId -> Java.Time.ZonedDateTime

參數

zone

ZoneId

使用時區，而非 null

傳回

ZonedDateTime

分區日期時間由此日期時間組成，而非零

屬性

RegisterAttribute

備註

將此日期時間與時區結合，建立 ZonedDateTime。 此時會回傳由該日期時間在指定時區形成的 ZonedDateTime。 結果會盡量與這個日期時間相符。 時區規則，例如夏令時間，意味著並非每個當地日期時間都適用於指定區域，因此當地日期時間可能會被調整。 當地日期時間解析為時間線上的單一瞬間。 這是透過尋找區域ID規則中定義的當地日期時間，從UTC/格林威治有效偏移量來達成的。 在大多數情況下，當地日期時間只有一個有效的偏移量。 在重疊的情況下，時鐘被往後調整，則有兩個有效的偏移量。 此方法使用較早的偏移量，通常對應於「夏季」的偏移。 在時間間隙的情況下，當時鐘向前跳動時，沒有有效的偏移量。 取而代之的是，當地日期時間會依照間隔長度調整為較晚。 對於典型的一小時夏令時間變更，當地日期時間會延後一小時，進入通常對應「夏季」的偏移量。 若要在重疊期間取得後期偏移量，請呼叫 ZonedDateTime.withLaterOffsetAtOverlap（） 來取得此方法的結果。 若在有空隙或重疊時拋出例外，請使用 ZonedDateTime.ofStrict（LocalDateTime， ZoneOffset， ZoneId）。

Java 參考 java.time.LocalDateTime.atZone。