Freigeben über


TimeZone.ToUniversalTime(DateTime) Methode

Definition

Gibt die Coordinated Universal Time (UTC) zurück, die einer angegebenen Zeit entspricht.

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.

Gibt zurück

DateTime

Ein DateTime-Objekt, dessen Wert die time entsprechende Coordinated Universal Time (UTC) ist.

Hinweise

Wenn die lokale Zeitzone die Sommerzeit beobachtet, wendet die aktuelle Anpassungsregel auf den time Parameter an, ToUniversalTime wenn die Konvertierung ausgeführt wird.

Hinweis

Die ToUniversalTime Methode erkennt nur die aktuelle Sommerzeitanpassungsregel für die lokale Zeitzone. Daher wird garantiert, dass die koordinierte Weltzeit (UTC) genau zurückgegeben wird, die nur während des Zeitraums entspricht, in dem die neueste Anpassungsregel wirksam ist. Es kann ungenaue Ergebnisse zurückgeben, wenn time es sich um einen historischen Datums- und Uhrzeitwert handelt, der einer vorherigen Anpassungsregel unterliegt.

Wenn der time Parameter eine mehrdeutige Zeit ist, geht die Methode davon aus, dass es sich um eine Standardzeit handelt. (Eine mehrdeutige Zeit ist eine, die entweder einer Standardzeit oder einer Sommerzeit in der lokalen Zeitzone zugeordnet werden kann.) Wenn time es sich um eine ungültige Uhrzeit handelt, subtrahiert die Methode einfach die Ortszeit vom UTC-Offset der lokalen Zeitzone, um UTC zurückzugeben. (Eine ungültige Zeit ist eine, die aufgrund der Anwendung von Sommerzeitanpassungsregeln nicht vorhanden ist.)

Da time in Bezug auf die aktuelle Zeitzone des aktuellen Systems interpretiert wird, kann sich das datum und die von dieser Methode zurückgegebene Uhrzeit unterscheiden, wenn eine Anwendung auf verschiedenen Computern oder auf demselben Computer mit unterschiedlichen Zeitzonen ausgeführt wird. Bei Fällen, in denen ein Datums- und Uhrzeitwert einen einzelnen, eindeutigen Zeitpunkt darstellen muss, verwenden Sie einen DateTimeOffset Wert, um die lokale Uhrzeit darzustellen.

Die ToUniversalTime Methode entspricht der TimeZoneInfo.ConvertTimeToUtc(DateTime) Methodenüberladung mit einem DateTime Parameter, dessen Kind Eigenschaft nicht gleich DateTimeKind.Utcist. Verwenden Sie nach Möglichkeit die TimeZoneInfo.ConvertTimeToUtc(DateTime) Methodenüberladung.

Gilt für

Siehe auch