TimeZone.ToUniversalTime(DateTime) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí standard UTC (Coordinated Universal Time), který odpovídá zadanému času.
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
Datum a čas
Návraty
Objekt DateTime , jehož hodnota je koordinovaný univerzální čas (UTC), který odpovídá time.
Poznámky
Pokud místní časové pásmo sleduje letní čas, ToUniversalTime použije aktuální pravidlo úpravy na time parametr při provádění převodu.
Poznámka
Metoda ToUniversalTime rozpoznává pouze aktuální pravidlo úpravy letního času pro místní časové pásmo. V důsledku toho je zaručeno, že přesně vrátí koordinovaný univerzální čas (UTC) odpovídající určitému místnímu času pouze během období, ve kterém platí nejnovější pravidlo úpravy. Pokud se jedná o historickou hodnotu data a času, která podléhá předchozímu pravidlu úpravy, může vrátit nepřesné výsledky time .
time Pokud je parametr nejednoznačným časem, metoda předpokládá, že se jedná o standardní čas. (Nejednoznačný čas je čas, který může mapovat buď na standardní čas, nebo na letní čas v místním časovém pásmu.) Pokud time je neplatný čas, metoda jednoduše odečte místní čas od posunu UTC místního časového pásma a vrátí utc. (Neplatný čas je ten, který neexistuje kvůli použití pravidel úpravy letního času.)
Vzhledem k tomu time , že je interpretován ve vztahu k aktuálnímu časovému pásmu v aktuálním systému, může se datum a čas vrácený touto metodou lišit, pokud je aplikace spuštěna na různých počítačích nebo na stejném počítači s různými časovými pásmy. V případech, kdy musí hodnota data a času představovat jeden jednoznačný bod v čase, použijte DateTimeOffset hodnotu k reprezentaci místního času.
Metoda ToUniversalTime odpovídá TimeZoneInfo.ConvertTimeToUtc(DateTime) přetížení metody s parametrem DateTime , jehož Kind vlastnost se nerovná DateTimeKind.Utc. Kdykoli je to možné, použijte TimeZoneInfo.ConvertTimeToUtc(DateTime) přetížení metody.