DateTimeOffset.UtcDateTime Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore DateTime che rappresenta la data e l'ora UTC (Coordinated Universal Time) dell'oggetto DateTimeOffset corrente.
public:
property DateTime UtcDateTime { DateTime get(); };
public DateTime UtcDateTime { get; }
member this.UtcDateTime : DateTime
Public ReadOnly Property UtcDateTime As DateTime
Valore della proprietà
Data e ora UTC (Coordinated Universal Time) dell'oggetto DateTimeOffset corrente.
Esempio
Nell'esempio seguente viene illustrato come usare la UtcDateTime proprietà per visualizzare un DateTimeOffset valore e la relativa ora UTC corrispondente.
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
Commenti
La UtcDateTime proprietà esegue una doppia conversione:
Converte la data e l'ora dell'oggetto corrente DateTimeOffset in Utc (Coordinated Universal Time). La conversione viene eseguita sottraendo il valore della Offset proprietà dalla data e dall'ora dell'oggetto corrente DateTimeOffset .
Converte il DateTimeOffset valore in un DateTime valore.
La Kind proprietà del valore restituito è impostata DateTime su DateTimeKind.Utc.
Il recupero del valore della UtcDateTime proprietà equivale a chiamare la proprietà dell'oggetto ToUniversalTime.DateTime
correnteDateTimeOffset, ad eccezione del fatto che la Kind proprietà del DateTime secondo valore è DateTimeKind.Unspecified.