TimeZone.ToUniversalTime(DateTime) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

TimeZone.cs

Zwraca uniwersalny czas koordynowany (UTC), który odpowiada określonej godzinie.

public:
 virtual DateTime ToUniversalTime(DateTime time);

public virtual DateTime ToUniversalTime (DateTime time);

abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime

Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Parametry

time

DateTime

Data i godzina.

Zwraca

DateTime

DateTime Obiekt, którego wartość jest uniwersalnym czasem koordynowanym (UTC), który odpowiada .time

Uwagi

Jeśli lokalna strefa czasowa obserwuje czas letni, ToUniversalTime stosuje bieżącą regułę korekty do parametru time podczas przeprowadzania konwersji.

Uwaga

Metoda ToUniversalTime rozpoznaje tylko bieżącą regułę korekty czasu letniego dla lokalnej strefy czasowej. W związku z tym gwarantowane jest dokładne zwrócenie uniwersalnego czasu koordynowanego (UTC) odpowiadającego określonemu czasowi lokalnemu tylko w okresie, w którym obowiązuje najnowsza reguła korekty. Może zwracać niedokładne wyniki, jeśli time jest historyczną wartością daty i godziny, która była objęta poprzednią regułą korekty.

time Jeśli parametr jest niejednoznacznym czasem, metoda zakłada, że jest to standardowy czas. (Niejednoznaczny czas to taki, który może mapować na czas standardowy lub na czas letni w lokalnej strefie czasowej). Jeśli time jest to nieprawidłowy czas, metoda po prostu odejmuje czas lokalny od przesunięcia UTC lokalnej strefy czasowej w celu zwrócenia czasu UTC. (Nieprawidłowy czas to taki, który nie istnieje z powodu zastosowania reguł korekty czasu letniego).

Ponieważ time jest interpretowana w odniesieniu do bieżącej strefy czasowej w bieżącym systemie, data i godzina zwrócona przez tę metodę mogą się różnić, jeśli aplikacja jest uruchamiana na różnych komputerach lub na tym samym komputerze z różnymi strefami czasowymi. W przypadkach, w których wartość daty i godziny musi reprezentować pojedynczy, jednoznaczny punkt w czasie, użyj DateTimeOffset wartości do reprezentowania czasu lokalnego.

Metoda ToUniversalTime odpowiada przeciążeniu metody za pomocą parametru DateTimeTimeZoneInfo.ConvertTimeToUtc(DateTime), którego Kind właściwość nie jest równa DateTimeKind.Utc. Jeśli to możliwe, użyj przeciążenia TimeZoneInfo.ConvertTimeToUtc(DateTime) metody.

Zobacz też

• ConvertTimeToUtc(DateTime)