TimeZone.GetUtcOffset(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 für die angegebene Ortszeit den Offset zur koordinierten Weltzeit (Coordinated Universal Time, UTC) zurück.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset (DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParameter
- time
- DateTime
Ein Datums- und Uhrzeitwert.
Gibt zurück
Der UTC-Offset (Coordinated Universal Time) von time.
Hinweise
Diese Methode gibt den Offset oder unterschied zwischen dem Parameter und koordinierter time Weltzeit (UTC) zurück. Dies bedeutet:
time = UTC + Offset
Die -Methode interpretiert die Zeitzone von time basierend auf ihrer Kind -Eigenschaft. Wenn der Wert der Kind Eigenschaft oder DateTimeKind.UnspecifiedistDateTimeKind.Local, gibt die Methode den Offset der lokalen Zeitzone zurück. Wenn der Wert der Kind -Eigenschaft ist DateTimeKind.Utc, gibt die -Methode einen Offset zurück, der gleich ist TimeSpan.Zero.
Wenn die lokale Zeitzone die Sommerzeit beobachtet, wendet die aktuelle Anpassungsregel auf antime, GetUtcOffset wenn der Offset der lokalen Zeitzone bestimmt wird. Das heißt, der von zurückgegebene GetUtcOffset Offset gibt an, ob time die Standardzeit der Zeitzone oder die Sommerzeit fällt.
Hinweis
Die GetUtcOffset -Methode erkennt nur die aktuelle Sommerzeitanpassungsregel für die lokale Zeitzone. Daher wird garantiert, dass der UTC-Offset einer Ortszeit nur in dem Zeitraum genau zurückgegeben wird, in dem die letzte Anpassungsregel in Kraft ist. Es kann ungenaue Ergebnisse zurückgeben, wenn time es sich um einen historischen Datums- und Uhrzeitwert handelt, der einer vorherigen Anpassungsregel unterliegt.
Die GetUtcOffset -Methode entspricht der TimeZoneInfo.GetUtcOffset -Methode. Verwenden Sie nach Möglichkeit die TimeZoneInfo.GetUtcOffset -Methode.
Da der durch dargestellte time Datums- und Uhrzeitwert und der Offset dieses Werts von UTC nicht eng gekoppelt sind, kann ein lokaler oder nicht angegebener Datums- und Uhrzeitwert einen anderen Offsetwert zurückgeben, wenn er auf verschiedenen Computern ausgeführt wird oder auf demselben Computer unter verschiedenen Zeitzonen ausgeführt wird. Wenn dieses Verhalten nicht erwünscht ist, verwenden Sie stattdessen einen DateTimeOffset -Wert. Der DateTimeOffset Datentyp koppelt einen Datums- und Uhrzeitwert eng mit seinem Offset von UTC.
