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 a koordinovaným univerzálním time časem (UTC). To je:
time = UTC + posun
Metoda interpretuje časové pásmo time na základě jeho Kind vlastnosti. Pokud je hodnota Kind vlastnosti DateTimeKind.Local nebo DateTimeKind.Unspecified, metoda vrátí posun místního časového pásma. Pokud je DateTimeKind.Utchodnota Kind vlastnosti , metoda vrátí posun rovnou TimeSpan.Zero.
Pokud místní časové pásmo sleduje letní čas, GetUtcOffset použije aktuální pravidlo úpravy při time určování posunu místního časového pásma. To znamená, že posun vrácený GetUtcOffset odráží, zda time spadá do standardního času časového pásma nebo do letního času.
Poznámka:
Metoda GetUtcOffset 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ým vrácením posunu UTC místního času pouze během období, ve kterém platí poslední 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 .
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 času UTC nejsou úzce svázané, může místní nebo nezadaná 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 páruje hodnotu data a času s posunem od UTC.
