DateTimeOffset.UtcDateTime Propriété

Définition

Obtient une valeur DateTime représentant la date et l'heure en temps universel de l'objet DateTimeOffset en cours.

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

Valeur de propriété

Date et heure en temps universel coordonné de l'objet DateTimeOffset actuel.

Exemples

L’exemple suivant montre comment utiliser la UtcDateTime propriété pour afficher une DateTimeOffset valeur et son heure UTC correspondante.

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

Remarques

La UtcDateTime propriété effectue une double conversion :

  • Il convertit la date et l’heure de l’objet actuel DateTimeOffset en temps universel coordonné (UTC). La conversion est effectuée en soustrayant la valeur de la Offset propriété de la date et de l’heure de l’objet actuel DateTimeOffset .

  • Elle convertit la DateTimeOffset valeur en valeur DateTime .

La Kind propriété de la valeur retournée DateTime est définie sur DateTimeKind.Utc.

La récupération de la valeur de la UtcDateTime propriété revient à appeler la propriété de ToUniversalTime.DateTime l’objet actuelDateTimeOffset, sauf que la Kind propriété de cette dernière DateTime valeur est DateTimeKind.Unspecified.

S’applique à