TimeZone.ToUniversalTime(DateTime) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回對應到某個指定時間的 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) 方法多載。