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 Sie die UtcDateTime-Eigenschaft verwenden, 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 wird durchgeführt, indem der Wert der Offset-Eigenschaft vom Datum und der Uhrzeit des aktuellen DateTimeOffset Objekts subtrahieren wird.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ückgegebenen DateTime Werts wird auf DateTimeKind.Utcfestgelegt.The Kind property of the returned DateTime value is set to DateTimeKind.Utc.

Das Abrufen des Werts der UtcDateTime-Eigenschaft entspricht dem Aufrufen der ToUniversalTime.DateTime-Eigenschaft des aktuellen DateTimeOffset Objekts, mit der Ausnahme, dass die Kind-Eigenschaft des letzteren DateTime Werts DateTimeKind.Unspecifiedist.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: