DateTime Struktur
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.
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
-
DateTime
- Atribut
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. |