TimeZone.GetUtcOffset(DateTime) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca przesunięcie czasu uniwersalnego koordynowanego (UTC) dla określonego czasu lokalnego.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset (DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParametry
- time
- DateTime
Wartość daty i godziny.
Zwraca
Przesunięcie czasu uniwersalnego koordynowanego (UTC) z time.
Uwagi
Ta metoda zwraca przesunięcie lub różnicę między parametrem time a uniwersalnym czasem koordynowanym (UTC). To znaczy:
time = UTC + przesunięcie
Metoda interpretuje strefę czasową time na podstawie jej Kind właściwości. Jeśli wartość Kind właściwości to DateTimeKind.Local lub DateTimeKind.Unspecified, metoda zwraca przesunięcie lokalnej strefy czasowej. Jeśli wartość Kind właściwości to DateTimeKind.Utc, metoda zwraca przesunięcie równe TimeSpan.Zero.
Jeśli lokalna strefa czasowa obserwuje czas letni, GetUtcOffset stosuje bieżącą regułę korekty do time podczas określania przesunięcia lokalnej strefy czasowej. Oznacza to, że przesunięcie zwrócone przez GetUtcOffset element odzwierciedla, czy time przypada w standardowym czasie strefy czasowej, czy w czasie letnim.
Uwaga
Metoda GetUtcOffset rozpoznaje tylko bieżącą regułę korekty czasu letniego dla lokalnej strefy czasowej. W związku z tym gwarantowane jest dokładne zwrócenie przesunięcia CZASU UTC czasu lokalnego tylko w okresie, w którym obowiązują najnowsza reguła korekty. Może zwracać niedokładne wyniki, jeśli time jest historyczną wartością daty i godziny, która była przedmiotem poprzedniej reguły korekty.
Metoda GetUtcOffset odpowiada metodzie TimeZoneInfo.GetUtcOffset . Jeśli to możliwe, użyj TimeZoneInfo.GetUtcOffset metody .
Ponieważ wartość daty i godziny reprezentowana przez time i przesunięcie tej wartości z czasu UTC nie jest ściśle powiązane, lokalna lub nieokreślona wartość daty i godziny może zwrócić inną wartość przesunięcia podczas uruchamiania na różnych komputerach lub w przypadku uruchamiania na tym samym komputerze w różnych strefach czasowych. Jeśli to zachowanie jest niepożądane, użyj DateTimeOffset wartości. Typ DateTimeOffset danych ściśle łączy wartość daty i godziny z przesunięciem z czasu UTC.
