Sdílet prostřednictvím


TimeZone.ToUniversalTime(DateTime) Metoda

Definice

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

Platí pro

Viz také