TimeZone.GetUtcOffset(DateTime) Methode

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

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 time basierend auf Ihrer Kind-Eigenschaft.The method interprets the time zone of time based on its Kind property. Wenn der Wert der Kind-Eigenschaft DateTimeKind.Local oder 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 der Kind-Eigenschaft DateTimeKind.Utcist, gibt die Methode einen Offset zurück, der gleich TimeSpan.Zeroist.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 time an, wenn der Offset der lokalen Zeitzone festgelegt 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 von GetUtcOffset zurückgegeben wird, gibt an, ob time in die Standardzeit der Zeitzone oder die Sommerzeit fällt.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

Hinweis

Mit der GetUtcOffset-Methode wird nur die aktuelle Anpassungs Regel für die Sommerzeit für die lokale Zeitzone erkannt.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ückgegeben, wenn time 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 durch time und der Offset dieses Werts von der UTC dargestellte Datums-und Uhrzeitwert 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 auf demselben Computer unter verschiedenen Zeitzonen ausgeführt wird.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 Sie stattdessen einen DateTimeOffset 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