语言

ZoneRules.GetOffset 方法

定义

重载

名称 说明
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。

适用于