TimeZone.GetUtcOffset(DateTime) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

TimeZone.cs

返回指定本地时间的协调世界时 (UTC) 偏移量。

public:
 abstract TimeSpan GetUtcOffset(DateTime time);

public abstract TimeSpan GetUtcOffset (DateTime time);

abstract member GetUtcOffset : DateTime -> TimeSpan

Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

参数

time

DateTime

日期和时间值。

返回

TimeSpan

与 time 相比的协调世界时 (UTC) 偏移量。

注解

此方法返回 参数与协调世界时 (UTC) 之间的 time 偏移量或差值。 即：

time = UTC + 偏移量

方法根据其 Kind 属性解释 的time时区。 如果 属性DateTimeKind.Local的Kind值为 或 DateTimeKind.Unspecified，则该方法返回本地时区的偏移量。 如果 属性DateTimeKind.Utc的Kind值为 ，则该方法返回等于 TimeSpan.Zero的偏移量。

如果本地时区遵循夏令时， GetUtcOffset 在确定本地时区的偏移量时，将当前调整规则 time 应用于 。 也就是说，返回 GetUtcOffset 的偏移量反映是落在时区的标准时间还是 time 夏令时。

注意

方法 GetUtcOffset 仅识别本地时区的当前夏令时调整规则。 因此，保证仅在最新调整规则生效期间准确返回本地时间的 UTC 偏移量。 如果 time 是受以前调整规则约束的历史日期和时间值，则可能会返回不准确的结果。

方法 GetUtcOffset 对应于 TimeZoneInfo.GetUtcOffset 方法。 尽可能使用 TimeZoneInfo.GetUtcOffset 方法。

由于 表示 time 的日期和时间值以及此值与 UTC 的偏移量不紧密耦合，因此，当在不同计算机上运行或在不同时区下在同一台计算机上运行时，本地或未指定的日期和时间值可能会返回不同的偏移值。 如果不需要此行为，请 DateTimeOffset 改用 值。 数据类型 DateTimeOffset 将日期和时间值与其相对于 UTC 的偏移量紧密耦合在一起。

另请参阅

• GetUtcOffset(DateTime)