TimeZone.ToLocalTime(DateTime) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die ortsspezifische Uhrzeit zurück, die einem angegebenen Datums- und Uhrzeitwert entspricht.
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 DateTimeParameter
- time
- DateTime
Eine koordinierte Weltzeit (UTC)-Zeit.
Gibt zurück
Ein DateTime Objekt, dessen Wert die Ortszeit ist, die entspricht time.
Hinweise
Die folgende Tabelle zeigt die Beziehung zwischen dem time Parameter und dem DateTime von dieser Methode zurückgegebenen Wert.
time Parameter |
Behavior | Rückgabewert |
|---|---|---|
| Eine koordinierte Weltzeit (UTC)-Zeit (DateTimeKind.Utc). | Wandelt die Zeit von UTC in die ortslokale Uhrzeit um. | Ein DateTime Objekt, dessen Wert die Ortszeit ist, die entspricht time. |
| Eine Ortszeit (DateTimeKind.Local). | Keine Konvertierung erforderlich. | Derselbe DateTime Wert, der durch den time Parameter dargestellt wird. |
| Eine nicht angegebene Zeit (DateTimeKind.Unspecified). | Es wird davon ausgegangen, dass die Zeit UTC ist und sie von UTC in die lokale Zeit konvertiert. | Ein DateTime Objekt, dessen Wert die Ortszeit ist, die entspricht time. |
Wenn die lokale Zeitzone Sommerzeit beobachtet, ToLocalTime wendet die aktuelle Anpassungsregel beim Ausführen der Konvertierung an time .
Note
Die ToLocalTime Methode erkennt nur die aktuelle Sommerzeitanpassungsregel für die lokale Zeitzone. Daher wird garantiert, dass die Ortszeit, die einer bestimmten UTC-Zeit entspricht, nur während des Zeitraums, in dem die neueste Anpassungsregel wirksam ist, korrekt zurückgegeben wird. Es kann ungenaue Ergebnisse zurückgeben, wenn time es sich um einen historischen Datums- und Uhrzeitwert handelt, der einer vorherigen Anpassungsregel unterliegt.
Die ToLocalTime Methode entspricht der Methode, auf die TimeZoneInfo.ConvertTimeFromUtc der destinationTimeZone Parameter festgelegt ist TimeZoneInfo.Local. Verwenden Sie nach Möglichkeit die TimeZoneInfo.ConvertTimeFromUtc Methode.
Hinweise für Vererber
Obwohl dies nicht erforderlich ist, sollten abgeleitete Klassen in den meisten Fällen die Standardimplementierung dieser Methode überschreiben. Das Verhalten der Standardimplementierung hängt von der Kind Eigenschaft des time Parameters ab. Wenn der Wert lautet Local, gibt diese Methode unverändert zurück time . Wenn der Wert entweder Utc ist oder Unspecified, wird von dieser Methode angenommen time , dass es SICH um UTC handelt und in die lokale Systemzeit konvertiert wird, ohne die GetUtcOffset(DateTime) Methode aufzurufen.
