TimeZone.ToUniversalTime(DateTime) Methode

Definition

Gibt die Coordinated Universal Time (UTC) zurück, die einer angegebenen Zeit entspricht.Returns the Coordinated Universal Time (UTC) that corresponds to a specified time.

public:
 virtual DateTime ToUniversalTime(DateTime time);
public virtual DateTime ToUniversalTime (DateTime time);
abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime
Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Parameter

time
DateTime

Ein Datum und eine Uhrzeit.A date and time.

Gibt zurück

Ein DateTime-Objekt, dessen Wert die time entsprechende Coordinated Universal Time (UTC) ist.A DateTime object whose value is the Coordinated Universal Time (UTC) that corresponds to time.

Hinweise

Wenn die lokale Zeitzone die Sommerzeit beobachtet, wendet ToUniversalTime die aktuelle Anpassungs Regel auf den time -Parameter an, wenn die Konvertierung durchgeführt wird.If the local time zone observes daylight saving time, ToUniversalTime applies the current adjustment rule to the time parameter when performing the conversion.

Hinweis

Die ToUniversalTime -Methode erkennt nur die aktuelle Anpassungs Regel für die Sommerzeit für die lokale Zeitzone.The ToUniversalTime method recognizes only the current daylight saving time adjustment rule for the local time zone. Folglich wird sichergestellt, dass die koordinierte Weltzeit (UTC) für eine bestimmte 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 Coordinated Universal Time (UTC) corresponding to a particular 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.

Wenn der time -Parameter eine mehrdeutige Zeit ist, geht die Methode davon aus, dass es sich um eine Standardzeit handelt.If the time parameter is an ambiguous time, the method assumes that it is a standard time. (Eine mehrdeutige Zeit ist eine, die entweder einer Standardzeit oder einer Sommerzeit in der lokalen Zeitzone zugeordnet werden kann.) Wenn time eine ungültige Zeit ist, subtrahiert die Methode einfach die lokale Zeit vom UTC-Offset der lokalen Zeitzone zur Rückgabe von UTC.(An ambiguous time is one that can map either to a standard time or to a daylight saving time in the local time zone.) If time is an invalid time, the method simply subtracts the local time from the local time zone's UTC offset to return UTC. (Eine ungültige Zeit ist eine, die aufgrund der Anwendung der Anpassungsregeln für die Sommerzeit nicht vorhanden ist.)(An invalid time is one that does not exist because of the application of daylight saving time adjustment rules.)

Da time in Bezug auf die aktuelle Zeitzone des aktuellen Systems interpretiert wird, können sich die von dieser Methode zurückgegebenen Datums-und Uhrzeitangaben unterscheiden, wenn eine Anwendung auf unterschiedlichen Computern oder auf demselben Computer mit unterschiedlichen Zeitzonen ausgeführt wird.Because time is interpreted in relation to the current time zone on the current system, the date and time returned by this method can differ if an application is run on different computers or on the same computer with different time zones. In Fällen, in denen ein Datums-und Uhrzeitwert einen einzelnen, eindeutigen Zeitpunkt darstellen muss, verwenden DateTimeOffset Sie einen-Wert, um die lokale Zeit darzustellen.For cases in which a date and time value must represent a single, unambiguous point in time, use a DateTimeOffset value to represent the local time.

Die ToUniversalTime -Methode entspricht der TimeZoneInfo.ConvertTimeToUtc(DateTime) -Methoden Überladung DateTime mit einem Kind -Parameter, dessen DateTimeKind.Utc-Eigenschaft nicht gleich ist.The ToUniversalTime method corresponds to the TimeZoneInfo.ConvertTimeToUtc(DateTime) method overload with a DateTime parameter whose Kind property does not equal DateTimeKind.Utc. Verwenden Sie nach Möglichkeit die TimeZoneInfo.ConvertTimeToUtc(DateTime) -Methoden Überladung.Whenever possible, use the TimeZoneInfo.ConvertTimeToUtc(DateTime) method overload.

Gilt für:

Siehe auch