TimeZone.ToLocalTime(DateTime) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Returnerar den lokala tid som motsvarar ett angivet datum- och tidsvärde.
public:
virtual DateTime ToLocalTime(DateTime time);public virtual DateTime ToLocalTime(DateTime time);abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTimePublic Overridable Function ToLocalTime (time As DateTime) As DateTimeParametrar
- time
- DateTime
En utc-tid (Coordinated Universal Time).
Returer
Ett DateTime objekt vars värde är den lokala tid som motsvarar time.
Kommentarer
I följande tabell visas relationen mellan parametern time och värdet DateTime som returneras av den här metoden.
time Parametern |
Behavior | Returvärde |
|---|---|---|
| En UTC-tid (Coordinated Universal Time) (DateTimeKind.Utc). | Konverterar tiden från UTC till den lokala tiden. | Ett DateTime objekt vars värde är den lokala tid som motsvarar time. |
| En lokal tid (DateTimeKind.Local). | Ingen konvertering krävs. | Samma DateTime värde som representeras av parametern time . |
| En ospecificerad tid (DateTimeKind.Unspecified). | Förutsätter att tiden är UTC och konverterar den från UTC till den lokala tiden. | Ett DateTime objekt vars värde är den lokala tid som motsvarar time. |
Om den lokala tidszonen observerar sommartid ToLocalTime tillämpar den aktuella justeringsregeln på time när konverteringen utförs.
Note
Metoden ToLocalTime identifierar endast den aktuella justeringsregeln för sommartid för den lokala tidszonen. Därför är det garanterat att korrekt returnera den lokala tid som motsvarar en viss UTC-tid endast under den period då den senaste justeringsregeln gäller. Det kan returnera felaktiga resultat om time är ett historiskt datum- och tidsvärde som var föremål för en tidigare justeringsregel.
Metoden ToLocalTime motsvarar metoden med parametern TimeZoneInfo.ConvertTimeFromUtcdestinationTimeZone inställd på TimeZoneInfo.Local. Använd metoden när det TimeZoneInfo.ConvertTimeFromUtc är möjligt.
Anteckningar till arvingar
Även om det inte krävs bör härledda klasser i de flesta fall åsidosätta standardimplementeringen av den här metoden. Beteendet för standardimplementeringen beror på Kind parameterns time egenskap. Om dess värde är Localreturnerar time den här metoden oförändrad. Om dess värde är antingen Utc eller Unspecifiedförutsätter time den här metoden att den är UTC och konverterar den till den lokala systemtiden utan att anropa GetUtcOffset(DateTime) metoden.
