DateTimeOffset.UtcDateTime プロパティ

定義

現在の DateTime オブジェクトの世界協定時刻 (UTC) の日時を表す DateTimeOffset 値を取得します。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

プロパティ値

現在の DateTimeOffset オブジェクトの世界協定時刻 (UTC) の日時。The Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

次の例では、UtcDateTime プロパティを使用して、DateTimeOffset 値とそれに対応する UTC 時刻を表示する方法を示します。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      
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      

注釈

UtcDateTime プロパティは、次の2つの変換を実行します。The UtcDateTime property performs a dual conversion:

  • 現在の DateTimeOffset オブジェクトの日付と時刻を世界協定時刻 (UTC) に変換します。It converts the date and time of the current DateTimeOffset object to Coordinated Universal Time (UTC). 変換は、現在の DateTimeOffset オブジェクトの日付と時刻から Offset プロパティの値を減算することによって行われます。The conversion is performed by subtracting the value of the Offset property from the date and time of the current DateTimeOffset object.

  • DateTimeOffset 値を DateTime 値に変換します。It converts the DateTimeOffset value to a DateTime value.

返された DateTime 値の Kind プロパティは DateTimeKind.Utcに設定されます。The Kind property of the returned DateTime value is set to DateTimeKind.Utc.

UtcDateTime プロパティの値を取得することは、現在の DateTimeOffset オブジェクトの ToUniversalTime.DateTime プロパティを呼び出すことと同じです。ただし、後者の DateTime 値の Kind プロパティは DateTimeKind.Unspecifiedです。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.

適用対象