TimeZone.GetUtcOffset(DateTime) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

TimeZone.cs

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 -> TimeSpan

Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Parametreler

time

DateTime

Tarih ve saat değeri.

Döndürülenler

TimeSpan

ile eşgüdümlü Evrensel Saat (UTC) uzaklığı time.

Açıklamalar

Bu yöntem, parametresi ile Eşgüdümlü Evrensel Saat (UTC) arasındaki time uzaklığı veya farkı döndürür. Bunun anlamı:

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öntem yerel saat diliminin uzaklığını döndürür. özelliğinin Kind değeri ise DateTimeKind.Utc, yöntemi değerine eşit TimeSpan.Zerobir uzaklık döndürür.

Yerel saat diliminde gün ışığından yararlanma saati gözlemleniyorsa, 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.

Not

GetUtcOffset yöntemi, yerel saat dilimi için yalnızca geçerli gün ışığından yararlanma saati ayarlama kuralını tanır. Sonuç olarak, yerel saatin UTC uzaklığını yalnızca en son ayarlama kuralının geçerli olduğu süre boyunca 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.

GetUtcOffset yöntemi yöntemine TimeZoneInfo.GetUtcOffset karşılık gelir. Mümkün olduğunda yöntemini kullanın TimeZoneInfo.GetUtcOffset .

ile time temsil edilen tarih ve saat değeri ve 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. DateTimeOffset Veri türü, utc'den uzaklığıyla bir tarih ve saat değerini sıkı bir şekilde birler.

Ayrıca bkz.

• GetUtcOffset(DateTime)