DateTimeOffset.UtcDateTime Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un valor DateTime que representa la fecha y hora de la hora universal coordinada (UTC) del objeto DateTimeOffset actual.
public:
property DateTime UtcDateTime { DateTime get(); };public DateTime UtcDateTime { get; }member this.UtcDateTime : DateTimePublic ReadOnly Property UtcDateTime As DateTimeValor de propiedad
Fecha y hora en hora universal coordinada (UTC) del objeto DateTimeOffset actual.
Ejemplos
En el ejemplo siguiente se muestra cómo usar la UtcDateTime propiedad para mostrar un DateTimeOffset valor y su hora UTC correspondiente.
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
Comentarios
La UtcDateTime propiedad realiza una conversión dual:
Convierte la fecha y hora del objeto actual DateTimeOffset en hora universal coordinada (UTC). La conversión se realiza restando el valor de la Offset propiedad de la fecha y hora del objeto actual DateTimeOffset .
Convierte el DateTimeOffset valor en un DateTime valor.
La Kind propiedad del valor devuelto DateTime se establece en DateTimeKind.Utc.
Recuperar el valor de la UtcDateTime propiedad equivale a llamar a la propiedad del ToUniversalTime.DateTime objeto actualDateTimeOffset, salvo que la Kind propiedad del último DateTime valor es DateTimeKind.Unspecified.
