DateTime Struktur

  • Referensi

Definisi

Ruang nama:
Windows.Foundation
Edit

Mewakili instan dalam waktu, biasanya dinyatakan sebagai tanggal dan jam hari.

Javascript Jenis ini muncul sebagai objek Tanggal .

.BERSIH Saat pemrograman dengan .NET, jenis ini disembunyikan, dan pengembang harus menggunakan struktur System.DateTimeOffset .

C++/CX Mirip dengan FILETIME tetapi dengan perbedaan penting. Lihat Keterangan.

C++/WinRT Jenis ini adalah spesialisasi std::chrono::time_point. Lihat Keterangan.

public value class DateTime
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct time_point
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct DateTimeOffset
var dateTime = {
universalTime : /* Your value */
}
Public Structure DateTimeOffset
Warisan
ValueType
DateTime
Atribut
ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (diperkenalkan dalam v1.0)

Keterangan

Bahasa JavaScript dan Microsoft .NET tidak menggunakan jenis ini secara langsung. Di JavaScript, DateTime diproyeksikan sebagai objek Tanggal , dan di Microsoft .NET diproyeksikan sebagai System.DateTimeOffset. Setiap bahasa secara transparan menangani konversi ke granularitas dan rentang tanggal untuk masing-masing bahasa.

Dalam ekstensi komponen Visual C++ (C++/CX), nilai DateTime.UniversalTime memiliki granularitas yang sama dengan FILETIME (interval 100-nanodetik). Untuk nilai positif, nilai DateTime.UniversalTime identik dengan nilai FILETIME meskipun hanya dapat mewakili tanggal hingga sekitar 29000 C.E. Nilai negatif menunjukkan jumlah interval sebelum 1 Januari 1601 dan dapat mewakili tanggal kembali ke sekitar 27.400 B.C.E. Untuk Kalender Gregorian, Anda dapat menggunakan DateTimeFormatter untuk membuat representasi string DateTime untuk tanggal setelah tengah malam pada Tahun 1 C.E.

Untuk mengonversi UniversalTime ke SYSTEMTIME, gunakan ULARGE_INTEGER untuk mengonversi nilai int64 ke FILETIME, lalu gunakan FileTimeToSystemTime untuk mendapatkan SYSTEMTIME.

Di C++/WinRT, DateTime mirip dengan C++/CX karena memiliki granularitas yang sama dengan FILETIME. Tidak seperti C++/CX, ini adalah spesialisasi std::chrono::time_point daripada struktur yang berbeda. C++/WinRT menyediakan fungsi pembantu untuk mengonversi DateTime ke dan dari FILETIME dan ke dan dari time_t. Untuk informasi selengkapnya tentang fungsi-fungsi ini, lihat winrt::clock struct.

Bidang

UniversalTime

Bilangan bulat bertanda tangan 64-bit yang mewakili titik waktu sebagai jumlah interval 100 nanodetik sebelum atau setelah tengah malam pada 1 Januari 1601 (menurut Kalender Gregorian).

Catatan

Di C++/WinRT, bidang ini tidak ada, karena dalam proyeksi bahasa DateTime adalah spesialisasi std::chrono::time_point. Jika Anda memerlukan nilai bilangan bulat mentah, gunakan time_point::time_since_epoch untuk mendapatkan std::chrono::d uration, dan gunakan metode hitungannya untuk mendapatkan jumlah mentah.

Berlaku untuk

Lihat juga