TimeZone.ToUniversalTime(DateTime) 方法

定義

傳回對應到某個指定時間的 Coordinated Universal Time (UTC)。

public:
 virtual DateTime ToUniversalTime(DateTime time);
public virtual DateTime ToUniversalTime (DateTime time);
abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime
Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

參數

time
DateTime

日期和時間。

傳回

DateTime 物件,其值是對應到 time 的 Coordinated Universal Time (UTC)。

備註

如果當地時區觀察到日光節約時間, ToUniversalTime 請在執行轉換時,將目前的調整規則套用至 time 參數。

注意

方法 ToUniversalTime 只會辨識當地時區目前的日光節約時間調整規則。 因此,保證只會在最新調整規則生效的期間,正確傳回與特定當地時間對應的國際標準時間 (UTC) 。 如果 time 是受先前調整規則約束的歷史日期和時間值,可能會傳回不正確的結果。

time如果參數是模棱兩可的時間,則方法會假設它是標準時間。 (模棱兩可的時間是可以對應至標準時間或當地時區的日光節約時間。) 如果 time 不正確時間,方法只會從當地時區的 UTC 位移減當地時間以傳回 UTC。 (不正確時間是因為日光節約時間調整規則的套用而不存在。)

由於 time 解譯與目前系統上目前時區有關,所以如果應用程式在不同的電腦上或在同一部具有不同時區的電腦上執行,則此方法所傳回的日期和時間可能會有所不同。 如果日期和時間值必須代表單一明確時間點,請使用 DateTimeOffset 值來代表當地時間。

方法 ToUniversalTime 會對應至 TimeZoneInfo.ConvertTimeToUtc(DateTime) 方法多載,其 DateTime 屬性不等於 DateTimeKind.Utc 的參數 Kind 。 盡可能使用 TimeZoneInfo.ConvertTimeToUtc(DateTime) 方法多載。

適用於

另請參閱