共用方式為


TimeZone.GetUtcOffset(DateTime) 方法

定義

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

日期和時間值。

傳回

Coordinated Universal Time (UTC) 之於 time 的位移。

備註

這個方法會傳回 參數與國際標準時間 (UTC) 之間的 time 位移或差異。 即:

time = UTC + 位移

方法會根據其 屬性解譯 的 Kind 時區 timeKind如果 屬性值為 DateTimeKind.LocalDateTimeKind.Unspecified ,則方法會傳回當地時區的位移。 Kind如果 屬性值為 DateTimeKind.Utc ,則方法會傳回等於 TimeSpan.Zero 的位移。

如果當地時區觀察到日光節約時間, GetUtcOffset 請在判斷當地時區的位移時,將目前的調整規則套用至 time 。 也就是說,所 GetUtcOffset 傳回的位移會 time 反映落在時區的標準時間或其日光節約時間。

注意

方法 GetUtcOffset 只會辨識當地時區目前的日光節約時間調整規則。 因此,保證只會在最新調整規則生效的期間,正確傳回當地時間的 UTC 位移。 如果 time 是受先前調整規則約束的歷史日期和時間值,可能會傳回不正確的結果。

方法 GetUtcOffset 會對應至 TimeZoneInfo.GetUtcOffset 方法。 盡可能使用 TimeZoneInfo.GetUtcOffset 方法。

因為 所 time 代表的日期和時間值與 UTC 的位移並未緊密結合,所以本機或未指定的日期和時間值可以在不同電腦上執行時,或在不同時區下在同一部電腦上執行時,傳回不同的位移值。 如果不需要此行為,請改用 DateTimeOffset 值。 DateTimeOffset資料類型會緊密結合日期和時間值與其從 UTC 的位移。

適用於

另請參閱