Sdílet prostřednictvím


TimeZone.ToLocalTime(DateTime) Metoda

Definice

Vrátí místní čas odpovídající zadané hodnotě data a času.

public:
 virtual DateTime ToLocalTime(DateTime time);
public virtual DateTime ToLocalTime (DateTime time);
abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTime
Public Overridable Function ToLocalTime (time As DateTime) As DateTime

Parametry

time
DateTime

Čas koordinovaného univerzálního času (UTC).

Návraty

DateTime

Objekt DateTime , jehož hodnota je místní čas, který odpovídá time.

Poznámky

Následující tabulka ukazuje relaci mezi parametrem time a DateTime hodnotou vrácenou touto metodou.

time Parametr Chování Vrácená hodnota
Čas koordinovaného univerzálního času (UTC) (DateTimeKind.Utc). Převede čas z UTC na místní čas. Objekt DateTime , jehož hodnota je místní čas, který odpovídá time.
Místní čas (DateTimeKind.Local). Není nutné provést převod. Stejná DateTime hodnota reprezentovaná parametrem time .
Nezadaná doba (DateTimeKind.Unspecified). Předpokládá, že čas je UTC a převede ho z UTC na místní čas. Objekt DateTime , jehož hodnota je místní čas, který odpovídá time.

Pokud místní časové pásmo sleduje letní čas, ToLocalTime použije při převodu aktuální pravidlo time úpravy.

Poznámka

Metoda ToLocalTime rozpozná 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 místní čas odpovídající určitému času UTC pouze během období, ve kterém je platné 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 .

Metoda ToLocalTime odpovídá TimeZoneInfo.ConvertTimeFromUtc metodě s parametrem destinationTimeZone nastaveným na TimeZoneInfo.Local. Kdykoli je to možné, použijte metodu TimeZoneInfo.ConvertTimeFromUtc .

Poznámky pro dědice

I když to není povinné, ve většině případů odvozené třídy spuštěné v .NET Framework verze 2.0 by měly přepsat výchozí implementaci této metody. V .NET Framework verze 1.0 a 1.1 metoda ToLocalTime volala metodu GetUtcOffset(DateTime) a upravila pro letní čas při vrácení místního času. Počínaje .NET Framework 2.0 však chování výchozí implementace závisí na Kind vlastnosti parametrutime. Pokud je Localjejí hodnota , tato metoda vrátí time beze změny. Pokud je jeho hodnota buď Utc nebo Unspecified, tato metoda předpokládá time , že je UTC a převede ji na místní systémový čas bez volání GetUtcOffset(DateTime) metody.

Následující kód poskytuje jednoduché přepsání výchozí implementace ToLocalTime metody. V tomto kódu internalTimeZone proměnná představuje privátní instanci TimeZone třídy:

Platí pro

Viz také