DateTimeOffset.UtcDateTime Properti

Definisi

DateTime Mendapatkan nilai yang mewakili tanggal dan waktu Waktu Universal Terkoordinasi (UTC) dari objek saat iniDateTimeOffset.

public:
 property DateTime UtcDateTime { DateTime get(); };
public DateTime UtcDateTime { get; }
member this.UtcDateTime : DateTime
Public ReadOnly Property UtcDateTime As DateTime

Nilai Properti

Tanggal dan waktu Waktu Universal Terkoordinasi (UTC) objek saat ini DateTimeOffset .

Contoh

Contoh berikut menunjukkan cara menggunakan UtcDateTime properti untuk menampilkan DateTimeOffset nilai dan waktu UTC yang sesuai.

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

Keterangan

Properti UtcDateTime melakukan konversi ganda:

  • Ini mengonversi tanggal dan waktu objek saat ini DateTimeOffset menjadi Waktu Universal Terkoordinasi (UTC). Konversi dilakukan dengan mengurangi nilai Offset properti dari tanggal dan waktu objek saat ini DateTimeOffset .

  • Ini mengonversi DateTimeOffset nilai menjadi DateTime nilai.

Properti Kind dari nilai yang dikembalikan DateTime diatur ke DateTimeKind.Utc.

Mengambil nilai UtcDateTime properti setara dengan memanggil properti objek ToUniversalTime.DateTime saat iniDateTimeOffset, kecuali bahwa Kind properti dari nilai terakhir DateTime adalah DateTimeKind.Unspecified.

Berlaku untuk