TimeZone.GetUtcOffset(DateTime) Metoda

Definicja

Zwraca przesunięcie uniwersalnego czasu koordynowanego (UTC) dla określonego czasu lokalnego.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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

Parametry

time
DateTime

Wartość daty i godziny.A date and time value.

Zwraca

TimeSpan

Przesunięcie uniwersalnego czasu koordynowanego (UTC) od time .The Coordinated Universal Time (UTC) offset from time.

Uwagi

Ta metoda zwraca przesunięcie lub różnicę między time parametrem i uniwersalnym czasem koordynowanym (UTC).This method returns the offset, or difference, between the time parameter and Coordinated Universal Time (UTC). To znaczy:That is:

time = UTC + przesunięcietime = UTC + offset

Metoda interpretuje strefę czasową time na podstawie jej Kind właściwości.The method interprets the time zone of time based on its Kind property. Jeśli wartość Kind właściwości jest DateTimeKind.Local lub DateTimeKind.Unspecified , metoda zwraca przesunięcie lokalnej strefy czasowej.If the value of the Kind property is DateTimeKind.Local or DateTimeKind.Unspecified, the method returns the offset of the local time zone. Jeśli wartość Kind właściwości jest DateTimeKind.Utc , metoda zwraca przesunięcie równe TimeSpan.Zero .If the value of the Kind property is DateTimeKind.Utc, the method returns an offset equal to TimeSpan.Zero.

Jeśli lokalna strefa czasowa zaobserwuje czas letni, GetUtcOffset stosuje bieżącą regułę korekty do time podczas określania przesunięcia lokalnej strefy czasowej.If the local time zone observes daylight saving time, GetUtcOffset applies the current adjustment rule to time when determining the offset of the local time zone. Oznacza to, że przesunięcie zwrócone przez GetUtcOffset odzwierciedla, czy time przypada w czasie standardowym strefy czasowej, czy czas letni.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

Uwaga

GetUtcOffsetMetoda rozpoznaje tylko bieżącą regułę korekty czasu letniego dla lokalnej strefy czasowej.The GetUtcOffset method recognizes only the current daylight saving time adjustment rule for the local time zone. W związku z tym jest gwarantowane dokładne zwrócenie przesunięcia UTC czasu lokalnego tylko w okresie, w którym obowiązuje Najnowsza reguła korygowania.As a result, it is guaranteed to accurately return the UTC offset of a local time only during the period in which the latest adjustment rule is in effect. Może zwracać niedokładne wyniki, jeśli time jest to historyczna wartość daty i godziny, która była objęta poprzednią regułą korekty.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

GetUtcOffsetMetoda odpowiada TimeZoneInfo.GetUtcOffset metodzie.The GetUtcOffset method corresponds to the TimeZoneInfo.GetUtcOffset method. Jeśli to możliwe, użyj TimeZoneInfo.GetUtcOffset metody.Whenever possible, use the TimeZoneInfo.GetUtcOffset method.

Ponieważ wartość daty i godziny reprezentowana przez time i przesunięcia wartości z UTC nie są ściśle sprzężone, lokalna lub nieokreślona wartość daty i godziny może zwracać inną wartość przesunięcia w przypadku uruchamiania na różnych komputerach lub w przypadku uruchamiania na tym samym komputerze w różnych strefach czasowych.Because the date and time value represented by time and this value's offset from UTC are not tightly coupled, a local or unspecified date and time value can return a different offset value when run on different computers or when run on the same computer under different time zones. Jeśli to zachowanie jest niepożądane, DateTimeOffset zamiast tego użyj wartości.If this behavior is undesirable, use a DateTimeOffset value instead. DateTimeOffsetTyp danych ściśle Couples wartość daty i godziny z przesunięciem od czasu UTC.The DateTimeOffset data type tightly couples a date and time value with its offset from UTC.

Dotyczy

Zobacz też