ZoneRules.GetOffset 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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 ,则引发规则不是固定偏移量。
注解
获取这些规则中指定本地日期时间的合适偏移量。 从本地日期时间到偏移量的映射并不简单。 有三种情况:正常,具有一个有效偏移量。 对于大部分年份,正常情况适用,其中本地日期时间存在单个有效偏移量:间隙,有效偏移量为零。 这是当时钟跳跃通常是由于春夏令时从“冬天”更改为“夏天”。 在间隙中,存在没有有效偏移量的本地日期时间值;重叠,具有两个有效偏移量。 这是当时钟被设置通常由于秋季夏令时从“夏季”更改为“冬季”。 在重叠中,有两个有效偏移量的本地日期时间值。 因此,对于任何给定的本地日期时间,可以有一两个有效偏移量。 此方法在 Normal 事例中返回单个偏移量,在 Gap 或 Overlap 事例中,它将返回转换前的偏移量。 由于在 Gap 和 Overlap 的情况下,返回的偏移量是“最佳”值,而不是“正确”值,因此应谨慎处理该值。 关心正确偏移的应用程序应结合使用此方法、getValidOffsets(LocalDateTime)和 getTransition(LocalDateTime)。
Java参考java.time.zone.ZoneRules.getOffset。