TimeZone.GetUtcOffset(DateTime) Methode

Definition

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 -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Parameter

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.

Gilt für:

Weitere Informationen