TimeZone.ToUniversalTime(DateTime) Yöntem

Tanım

Belirtilen saate karşılık gelen Eşgüdümlü Evrensel Saati (UTC) döndürür.

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

Parametreler

time
DateTime

Tarih ve saat.

Döndürülenler

DateTime

DateTime değerine karşılık gelen Eşgüdümlü Evrensel Saat (UTC) değerine sahip timebir nesne.

Açıklamalar

Yerel saat dilimi gün ışığından yararlanma saatini gözlemliyorsa, ToUniversalTime dönüştürmeyi gerçekleştirirken geçerli ayarlama kuralını time parametresine uygular.

Not

ToUniversalTime yöntemi, yerel saat dilimi için yalnızca geçerli gün ışığından yararlanma saati ayarlama kuralını tanır. Sonuç olarak, yalnızca en son ayarlama kuralının geçerli olduğu dönemde belirli bir yerel saate karşılık gelen Eşgüdümlü Evrensel Saat'i (UTC) doğru bir şekilde döndürmesi garanti edilir. Önceki ayarlama kuralına tabi geçmiş bir tarih ve saat değeriyse time yanlış sonuçlar döndürebilir.

time Parametre belirsiz bir zamansa, yöntemi bunun standart bir saat olduğunu varsayar. (Belirsiz saat, standart saatle veya yerel saat dilimindeki yaz saatiyle eşlenebilir saattir.) Geçersiz bir saatse time yöntemi, UTC döndürmek için yerel saati yerel saat diliminin UTC uzaklığından çıkarır. (Geçersiz bir saat, yaz saati ayarlama kurallarının uygulanması nedeniyle var olmayan saattir.)

time Geçerli sistemdeki geçerli saat dilimiyle ilgili olarak yorumlandığından, bir uygulama farklı bilgisayarlarda veya farklı saat dilimlerine sahip aynı bilgisayarda çalıştırılırsa, bu yöntem tarafından döndürülen tarih ve saat farklı olabilir. Tarih ve saat değerinin zaman içinde tek ve net bir noktayı temsil etmesi gereken durumlarda, yerel saati temsil etmek için bir DateTimeOffset değer kullanın.

yöntemi, ToUniversalTime özelliği eşit DateTimeKind.Utcolmayan bir DateTime parametre Kind ile yöntem aşırı yüklemesine karşılık gelirTimeZoneInfo.ConvertTimeToUtc(DateTime). Mümkün olduğunda yöntem aşırı yüklemesini TimeZoneInfo.ConvertTimeToUtc(DateTime) kullanın.

Şunlara uygulanır

Ayrıca bkz.