Udostępnij za pośrednictwem


TimeZone.GetUtcOffset(DateTime) Metoda

Definicja

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 -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Parametry

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.

Dotyczy

Zobacz też