TimeZone.ToUniversalTime(DateTime) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

TimeZone.cs

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 -> DateTime

Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Parametry

time

DateTime

Datum a čas.

Návraty

DateTime

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 bude přesně vracet koordinovaný univerzální čas (UTC) odpovídající určitému místnímu času pouze během období, ve kterém je platné nejnovější pravidlo úpravy. Pokud se jedná o historickou hodnotu data a času, která byla předmětem předchozího pravidla ú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 k vrácení 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, datum a čas vrácený touto metodou se může 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 hodnota data a času musí 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.

Viz také

• ConvertTimeToUtc(DateTime)