TimeZone.GetUtcOffset(DateTime) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen yerel saat için Eşgüdümlü Evrensel Saat (UTC) uzaklığını döndürür.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset(DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParametreler
- time
- DateTime
Tarih ve saat değeri.
Döndürülenler
ile timeEşgüdümlü Evrensel Saat (UTC) uzaklığı.
Açıklamalar
Bu yöntem parametre ile Eşgüdümlü Evrensel Saat (UTC) arasındaki time uzaklığı veya farkı döndürür. Yani:
time = UTC + uzaklık
yöntemi, saat dilimini time özelliğine Kind göre yorumlar. özelliğinin Kind değeri veya DateTimeKind.UnspecifiediseDateTimeKind.Local, yöntemi yerel saat diliminin uzaklığını döndürür. özelliğinin Kind değeri ise DateTimeKind.Utcyöntemi, değerine eşit TimeSpan.Zerobir uzaklık döndürür.
Yerel saat dilimi gün ışığından yararlanma saatini gözlemlerse, GetUtcOffset yerel saat diliminin uzaklığını belirlerken geçerli ayarlama kuralını time uygular. Başka bir ifadeyle döndürülen GetUtcOffset uzaklık, saat diliminin standart saatine mi yoksa yaz saati saatine mi time denk geldiğini yansıtır.
Uyarı
GetUtcOffset 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 süre boyunca yerel saatin UTC uzaklığını doğru bir şekilde döndürmek garanti edilir. Önceki bir ayarlama kuralına tabi geçmiş bir tarih ve saat değeriyse time yanlış sonuçlar döndürebilir.
GetUtcOffset yöntemi yöntemine TimeZoneInfo.GetUtcOffset karşılık gelir. Mümkün olduğunda yöntemini kullanın TimeZoneInfo.GetUtcOffset .
ile temsil edilen time tarih ve saat değeri ile bu değerin UTC'den uzaklığı sıkı bir şekilde birleştirilmediğinden, yerel veya belirtilmemiş bir tarih ve saat değeri, farklı bilgisayarlarda çalıştırıldığında veya aynı bilgisayarda farklı saat dilimleri altında çalıştırıldığında farklı bir uzaklık değeri döndürebilir. Bu davranış istenmeyen bir davranışsa, bunun yerine bir DateTimeOffset değer kullanın. Veri DateTimeOffset türü bir tarih ve saat değerini UTC'den uzaklığıyla sıkı bir şekilde bir arada oluşturur.
