TimeZone.GetUtcOffset(DateTime) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
傳回指定之當地時間的 Coordinated Universal Time (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
日期和時間值。
傳回
Coordinated Universal Time (UTC) 之於 time 的位移。
備註
這個方法會傳回 參數與國際標準時間 (UTC) 之間的 time 位移或差異。 即：
time = UTC + 位移
方法會根據其 屬性解譯 的 Kind 時區 time 。
Kind如果 屬性值為 DateTimeKind.Local 或 DateTimeKind.Unspecified ，則方法會傳回當地時區的位移。
Kind如果 屬性值為 DateTimeKind.Utc ，則方法會傳回等於 TimeSpan.Zero 的位移。
如果當地時區觀察到日光節約時間， GetUtcOffset 請在判斷當地時區的位移時，將目前的調整規則套用至 time 。 也就是說，所 GetUtcOffset 傳回的位移會 time 反映落在時區的標準時間或其日光節約時間。
注意
方法 GetUtcOffset 只會辨識當地時區目前的日光節約時間調整規則。 因此，保證只會在最新調整規則生效的期間，正確傳回當地時間的 UTC 位移。 如果 time 是受先前調整規則約束的歷史日期和時間值，可能會傳回不正確的結果。
方法 GetUtcOffset 會對應至 TimeZoneInfo.GetUtcOffset 方法。 盡可能使用 TimeZoneInfo.GetUtcOffset 方法。
因為 所 time 代表的日期和時間值與 UTC 的位移並未緊密結合，所以本機或未指定的日期和時間值可以在不同電腦上執行時，或在不同時區下在同一部電腦上執行時，傳回不同的位移值。 如果不需要此行為，請改用 DateTimeOffset 值。
DateTimeOffset資料類型會緊密結合日期和時間值與其從 UTC 的位移。
