TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) Method

Definition

Gibt für die angegebene Ortszeit den Offset zur koordinierten Weltzeit (Coordinated Universal Time, UTC) zurück.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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 DateTime DateTime DateTime

Ein Datums- und Uhrzeitwert.A date and time value.

Gibt zurück

Der UTC-Offset (Coordinated Universal Time) von time.The Coordinated Universal Time (UTC) offset from time.

Hinweise

Diese Methode gibt den Offset oder die Differenz zwischen dem time -Parameter und der koordinierten Weltzeit (UTC) zurück.This method returns the offset, or difference, between the time parameter and Coordinated Universal Time (UTC). Dies bedeutet:That is:

time= UTC + Offsettime = UTC + offset

Die-Methode interpretiert die Zeitzone von time basierend Kind auf der-Eigenschaft.The method interprets the time zone of time based on its Kind property. Wenn der Wert Kind der-Eigenschaft oder DateTimeKind.Local DateTimeKind.Unspecifiedist, gibt die Methode den Offset der lokalen Zeitzone zurück.If the value of the Kind property is DateTimeKind.Local or DateTimeKind.Unspecified, the method returns the offset of the local time zone. Wenn der Wert Kind der-Eigenschaft ist DateTimeKind.Utc, TimeSpan.Zerogibt die Methode einen Offset zurück, der gleich ist.If the value of the Kind property is DateTimeKind.Utc, the method returns an offset equal to TimeSpan.Zero.

Wenn die lokale Zeitzone die Sommerzeit beobachtet, wendet GetUtcOffset die aktuelle Anpassungs Regel auf an time , wenn der Offset der lokalen Zeitzone bestimmt wird.If the local time zone observes daylight saving time, GetUtcOffset applies the current adjustment rule to time when determining the offset of the local time zone. Das heißt, der Offset, der GetUtcOffset von zurück time gegeben wird, gibt an, ob die Standardzeit der Zeitzone oder die Sommerzeit liegt.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

Hinweis

Die GetUtcOffset -Methode erkennt nur die aktuelle Anpassungs Regel für die Sommerzeit für die lokale Zeitzone.The GetUtcOffset method recognizes only the current daylight saving time adjustment rule for the local time zone. Folglich wird garantiert, dass der UTC-Offset einer Ortszeit nur während des Zeitraums, in dem die aktuelle Anpassungs Regel wirksam ist, genau zurückgegeben wird.As a result, it is guaranteed to accurately return the UTC offset of a local time only during the period in which the latest adjustment rule is in effect. Möglicherweise werden falsche Ergebnisse zurück time gegeben, wenn ein historischer Datums-und Uhrzeitwert ist, der einer vorherigen Anpassungs Regel unterliegt.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

Die GetUtcOffset -Methode entspricht der TimeZoneInfo.GetUtcOffset -Methode.The GetUtcOffset method corresponds to the TimeZoneInfo.GetUtcOffset method. Verwenden Sie nach Möglichkeit die TimeZoneInfo.GetUtcOffset -Methode.Whenever possible, use the TimeZoneInfo.GetUtcOffset method.

Da der von time dargestellte 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 Offset Wert zurückgeben, wenn er auf verschiedenen Computern ausgeführt wird, oder wenn er auf demselben Computer wie ausgeführt wird. unterschiedliche Zeitzonen.Because the date and time value represented by time and this value's offset from UTC are not tightly coupled, a local or unspecified date and time value can return a different offset value when run on different computers or when run on the same computer under different time zones. Wenn dieses Verhalten nicht erwünscht ist, verwenden DateTimeOffset Sie stattdessen einen-Wert.If this behavior is undesirable, use a DateTimeOffset value instead. Der DateTimeOffset -Datentyp verbindet einen Datums-und Uhrzeitwert eng mit dem Offset von der UTC.The DateTimeOffset data type tightly couples a date and time value with its offset from UTC.

Gilt für:

Siehe auch