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 : DateTime
Public ReadOnly Property UtcDateTime As DateTime
Property 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.
Applies to
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기