Partager via

DateTimeOffset.UtcDateTime Propriété

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs

Obtient une DateTime valeur qui représente la date et l’heure UTC (Temps universel coordonné) de l’objet actif DateTimeOffset .

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

Valeur de propriété

DateTime

Date et heure UTC (Temps universel coordonné) de l’objet actif DateTimeOffset .

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 :

  • Elle 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 propriété à partir de la Offset 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é équivaut à appeler la propriété de ToUniversalTime.DateTime l’objet actuelDateTimeOffset, sauf que la Kind propriété de la dernière DateTime valeur est DateTimeKind.Unspecified.

S’applique à