ZoneRules.GetOffset メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| 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され、ルールが固定オフセットでない場合にスローされます。
注釈
これらのルールの指定した瞬間に適用できるオフセットを取得します。 インスタントからオフセットへのマッピングは単純であり、各インスタントに対して有効なオフセットは 1 つだけです。 このメソッドは、そのオフセットを返します。
適用対象
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され、ルールが固定オフセットでない場合にスローされます。
注釈
これらのルールで指定されたローカル日時に適したオフセットを取得します。 ローカル日時からオフセットへのマッピングは簡単ではありません。 次の 3 つのケースがあります。標準で、有効なオフセットが 1 つあります。 年の大部分では、通常のケースが適用され、ローカル日時に対して有効なオフセットが 1 つあります。ギャップ。有効なオフセットが 0 です。 これは、春の夏時間が "冬" から "夏" に変わるため、通常は時計が前方にジャンプする場合です。 ギャップには、有効なオフセットのないローカルの日時値があります。2 つの有効なオフセットと重複します。 これは、秋の夏時間が「夏」から「冬」に変わるため、時計が一般的に戻ってくるときです。 重複する場合、2 つの有効なオフセットを持つローカルの日時値があります。 したがって、特定のローカル日時に対して、0 個、1 つまたは 2 つの有効なオフセットを指定できます。 このメソッドは、標準の場合は単一のオフセットを返し、Gap または Overlap の場合は遷移前のオフセットを返します。 Gap と Overlap の場合、返されるオフセットは "最適" 値であるため、"正しい" 値ではなく、慎重に処理する必要があります。 正しいオフセットを考慮するアプリケーションでは、このメソッド getValidOffsets(LocalDateTime) と getTransition(LocalDateTime) の組み合わせを使用する必要があります。