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.

Note

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)