TimeZone.GetUtcOffset(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í 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 -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParametry
- 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.
