DateTimeOffset.UtcDateTime Eigenschap

Definitie

Hiermee haalt u een DateTime waarde op die de utc-datum (Coordinated Universal Time) en -tijd van het huidige DateTimeOffset object vertegenwoordigt.

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

Waarde van eigenschap

De utc-datum en -tijd (Coordinated Universal Time) van het huidige DateTimeOffset object.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de UtcDateTime eigenschap gebruikt om een DateTimeOffset waarde en de bijbehorende UTC-tijd weer te geven.

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
let offsetTime = DateTimeOffset(2007, 11, 25, 11, 14, 00, TimeSpan(3, 0, 0))
printfn $"{offsetTime} is equivalent to {offsetTime.UtcDateTime} {offsetTime.UtcDateTime.Kind}"
// 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

Opmerkingen

De UtcDateTime eigenschap voert een dubbele conversie uit:

  • Hiermee wordt de datum en tijd van het huidige DateTimeOffset object geconverteerd naar Coordinated Universal Time (UTC). De conversie wordt uitgevoerd door de waarde van de Offset eigenschap af te trekken van de datum en tijd van het huidige DateTimeOffset object.

  • De waarde wordt geconverteerd DateTimeOffset naar een DateTime waarde.

De Kind eigenschap van de geretourneerde DateTime waarde is ingesteld op DateTimeKind.Utc.

Het ophalen van de waarde van de UtcDateTime eigenschap komt overeen met het aanroepen van de eigenschap van het huidige DateTimeOffset object ToUniversalTime.DateTime , behalve dat de Kind eigenschap van de laatste DateTime waarde is DateTimeKind.Unspecified.

Van toepassing op