DateTimeOffset.UtcDateTime Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.