DateTimeOffset.UtcDateTime Eigenschaft

Definition

Ruft einen DateTime-Wert ab, der die UTC (Coordinated Universal Time)-Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts darstellt.Gets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

public:
 property DateTime UtcDateTime { DateTime get(); };
public DateTime UtcDateTime { get; }
member this.UtcDateTime : DateTime
Public ReadOnly Property UtcDateTime As DateTime

Eigenschaftswert

Die UTC (Coordinated Universal Time)-Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts.The Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die UtcDateTime -Eigenschaft verwendet wird, um einen DateTimeOffset Wert und die entsprechende UTC-Zeit anzuzeigen.The following example shows how to use of the UtcDateTime property to display a DateTimeOffset value and its corresponding UTC time.

DateTimeOffset offsetTime = new DateTimeOffset(2007, 11, 25, 11, 14, 00, 
                            new TimeSpan(3, 0, 0));
Console.WriteLine("{0} is equivalent to {1} {2}", 
                  offsetTime.ToString(), 
                  offsetTime.UtcDateTime.ToString(), 
                  offsetTime.UtcDateTime.Kind.ToString());      
// The example displays the following output:
//       11/25/2007 11:14:00 AM +03:00 is equivalent to 11/25/2007 8:14:00 AM Utc      
Dim offsetTime As New DateTimeOffset(#11/25/2007 11:14AM#, _
                  New TimeSpan(3, 0, 0))
Console.WriteLine("{0} is equivalent to {1} {2}", _
                  offsetTime.ToString(), _
                  offsetTime.UtcDateTime.ToString(), _
                  offsetTime.UtcDateTime.Kind.ToString())      
' The example displays the following output:
'       11/25/2007 11:14:00 AM +03:00 is equivalent to 11/25/2007 8:14:00 AM Utc      

Hinweise

Die UtcDateTime -Eigenschaft führt eine Dual Konvertierung durch:The UtcDateTime property performs a dual conversion:

  • Dabei werden das Datum und die Uhrzeit des aktuellen DateTimeOffset -Objekts in die koordinierte Weltzeit (UTC) konvertiert.It converts the date and time of the current DateTimeOffset object to Coordinated Universal Time (UTC). Die Konvertierung erfolgt durch Subtraktion des Werts der Offset -Eigenschaft vom Datum und der Uhrzeit des aktuellen DateTimeOffset -Objekts.The conversion is performed by subtracting the value of the Offset property from the date and time of the current DateTimeOffset object.

  • Der DateTimeOffset Wert wird in einen DateTime -Wert konvertiert.It converts the DateTimeOffset value to a DateTime value.

Die Kind -Eigenschaft des zurück DateTime gegebenen Werts wird auf DateTimeKind.Utcfestgelegt.The Kind property of the returned DateTime value is set to DateTimeKind.Utc.

Das Abrufen des UtcDateTime Werts der-Eigenschaft entspricht dem Aufrufen der-Eigenschaft des aktuellen ToUniversalTime.DateTime DateTimeOffset -Objekts, mit der Kind Ausnahme, dass die DateTime -Eigenschaft DateTimeKind.Unspecifieddes letzteren Werts ist.Retrieving the value of the UtcDateTime property is equivalent to calling the current DateTimeOffset object's ToUniversalTime.DateTime property, except that the Kind property of the latter DateTime value is DateTimeKind.Unspecified.

Gilt für: