TimeZone.GetUtcOffset(DateTime) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回指定本地时间的协调世界时 (UTC) 偏移量。
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset (DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan参数
- time
- DateTime
日期和时间值。
返回
与 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 的偏移量紧密耦合在一起。
