TimeZone.ToUniversalTime(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 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 -> DateTimePublic Overridable Function ToUniversalTime (time As DateTime) As DateTimeParametry
- time
- DateTime
Data i godzina.
Zwraca
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.
