Sdílet prostřednictvím


TimeZone.GetUtcOffset(DateTime) Metoda

Definice

Vrátí posun koordinovaného univerzálního času (UTC) pro zadaný místní čas.

public:
 abstract TimeSpan GetUtcOffset(DateTime time);
public abstract TimeSpan GetUtcOffset (DateTime time);
abstract member GetUtcOffset : DateTime -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Parametry

time
DateTime

Hodnota data a času

Návraty

Posun koordinovaného univerzálního času (UTC) od time.

Poznámky

Tato metoda vrátí posun nebo rozdíl mezi parametrem time a koordinovaným univerzálním časem (UTC). Požadavky:

time = UTC + posun

Metoda interpretuje časové pásmo na time základě jeho Kind vlastnosti. Pokud je DateTimeKind.Local hodnota Kind vlastnosti nebo DateTimeKind.Unspecified, vrátí metoda posun místního časového pásma. Pokud je DateTimeKind.Utchodnota Kind vlastnosti , vrátí metoda posun rovnající se hodnotě TimeSpan.Zero.

Pokud místní časové pásmo dodržuje letní čas, GetUtcOffset použije aktuální pravidlo úpravy na time při určování posunu místního časového pásma. To znamená, že posun vrácený funkcí GetUtcOffset odráží, zda time spadá do standardního času časového pásma nebo do jeho letního času.

Poznámka

Metoda GetUtcOffset rozpozná pouze aktuální pravidlo úprav letního času pro místní časové pásmo. V důsledku toho je zaručeno, že se přesně vrátí posun UTC místního času pouze během období, ve kterém platí nejnovější pravidlo úpravy. Pokud se jedná o historickou hodnotu data a času, která podléhala předchozímu pravidlu úpravy, může vrátit nepřesné výsledky time .

Metoda GetUtcOffset odpovídá TimeZoneInfo.GetUtcOffset metodě . Kdykoli je to možné, použijte metodu TimeZoneInfo.GetUtcOffset .

Vzhledem k tomu, že hodnota data a času reprezentovaná time a posun této hodnoty od utc nejsou úzce svázané, může místní nebo nespecifikovaná hodnota data a času vrátit jinou hodnotu posunu při spuštění na různých počítačích nebo při spuštění na stejném počítači v různých časových pásmech. Pokud je toto chování nežádoucí, použijte DateTimeOffset místo toho hodnotu. Datový DateTimeOffset typ úzce spojuje hodnotu data a času s posunem od času UTC.

Platí pro

Viz také