TimeZone.GetUtcOffset(DateTime) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

TimeZone.cs

傳回指定之當地時間的 Coordinated Universal Time (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

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 的位移。

另請參閱

• GetUtcOffset(DateTime)