DateTimeOffset.UtcDateTime Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.
public:
property DateTime UtcDateTime { DateTime get(); };public DateTime UtcDateTime { get; }member this.UtcDateTime : DateTimePublic ReadOnly Property UtcDateTime As DateTimeProperty Value
The Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.
Examples
The following example shows how to use of the UtcDateTime property to display a DateTimeOffset value and its corresponding UTC time.
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
Remarks
The UtcDateTime property performs a dual conversion:
It converts the date and time of the current DateTimeOffset object to Coordinated Universal Time (UTC). The conversion is performed by subtracting the value of the Offset property from the date and time of the current DateTimeOffset object.
It converts the DateTimeOffset value to a DateTime value.
The Kind property of the returned DateTime value is set to DateTimeKind.Utc.
Retrieving the value of the UtcDateTime property is equivalent to calling the current DateTimeOffset object's ToUniversalTime.DateTime property, except that the Kind property of the latter DateTime value is DateTimeKind.Unspecified.
