ZoneRules.GetOffset 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| GetOffset(Instant) |
取得這些規則中指定時刻適用的偏移量。 |
| GetOffset(LocalDateTime) |
在這些規則中，會根據指定的當地日期時間獲得適當的偏移量。 |
GetOffset(Instant)
取得這些規則中指定時刻適用的偏移量。
[Android.Runtime.Register("getOffset", "(Ljava/time/Instant;)Ljava/time/ZoneOffset;", "", ApiSince=26)]
public Java.Time.ZoneOffset? GetOffset(Java.Time.Instant? instant);[<Android.Runtime.Register("getOffset", "(Ljava/time/Instant;)Ljava/time/ZoneOffset;", "", ApiSince=26)>]
member this.GetOffset : Java.Time.Instant -> Java.Time.ZoneOffset參數
- instant
- Instant
找到偏移量的瞬間。 固定偏移規則可忽略 null;變數規則則不行。
傳回
該偏移量在指定時刻適用。
- 屬性
例外狀況
如果 instant 是 null 且規則不是固定偏移，則會被拋出。
備註
取得這些規則中指定時刻適用的偏移量。 從瞬間映射到偏移量很簡單，每個瞬間只有一個有效的偏移量。 此方法會回傳該偏移量。
Java 參考 java.time.zone.ZoneRules.getOffset。
適用於
GetOffset(LocalDateTime)
在這些規則中，會根據指定的當地日期時間獲得適當的偏移量。
[Android.Runtime.Register("getOffset", "(Ljava/time/LocalDateTime;)Ljava/time/ZoneOffset;", "", ApiSince=26)]
public Java.Time.ZoneOffset? GetOffset(Java.Time.LocalDateTime? localDateTime);[<Android.Runtime.Register("getOffset", "(Ljava/time/LocalDateTime;)Ljava/time/ZoneOffset;", "", ApiSince=26)>]
member this.GetOffset : Java.Time.LocalDateTime -> Java.Time.ZoneOffset參數
- localDateTime
- LocalDateTime
查詢的當地日期時間。 固定偏移規則可忽略 null;變數規則則不行。
傳回
當地日期時間的最佳可選偏移;對於間隙或重疊，則是指轉換前的偏移量。
- 屬性
例外狀況
如果 localDateTime 是 null 且規則不是固定偏移，則會被拋出。
備註
在這些規則中，會根據指定的當地日期時間獲得適當的偏移量。 從當地日期時間映射到偏移量並不簡單。 有三種情況：正常，且有一個有效的偏移量。 在一年中的絕大多數時間，適用正常情況，當地日期時間有一個有效的偏移;間隙，且有效偏移量為零。 這通常是因為春季夏令時間從「冬季」轉為「夏季」而時鐘跳動。 在空隙中存在局部的日期-時間值，且沒有有效的偏移量;重疊，且有兩個有效的偏移量。 這通常是因為秋季夏令時間從「夏季」改為「冬季」而將時鐘調回。 在重疊中，存在具有兩個有效偏移量的本地日期-時間值。 因此，對於任一給定的當地日期-時間，可以有零、一或兩個有效的偏移量。 此方法在正常情況下回傳單一偏移量，在間隙或重疊情況下回傳轉換前的偏移量。 由於在差距與重疊的情況下，回傳的偏移量是「最佳」值，而非「正確」值，因此應謹慎處理。 關心正確偏移量的應用程式應結合此方法，getValidOffsets（LocalDateTime）與 getTransition（LocalDateTime）。
Java 參考 java.time.zone.ZoneRules.getOffset。