Struktur SYSTEMTIME (minwinbase.h)

Artikel
08/24/2023

Menentukan tanggal dan waktu, menggunakan anggota individu untuk bulan, hari, tahun, hari kerja, jam, menit, detik, dan milidetik. Waktunya baik dalam waktu universal terkoordinasi (UTC) atau waktu setempat, tergantung pada fungsi yang sedang dipanggil.

Sintaks

typedef struct _SYSTEMTIME {
  WORD wYear;
  WORD wMonth;
  WORD wDayOfWeek;
  WORD wDay;
  WORD wHour;
  WORD wMinute;
  WORD wSecond;
  WORD wMilliseconds;
} SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME;

Anggota

wYear

Tahun ini. Nilai yang valid untuk anggota ini adalah 1601 hingga 30827.

wMonth

Bulan. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
1	Januari
2	Februari
3	Maret
4	April
5	Mei
6	Juni
7	Juli
8	Agustus
9	September
10	Oktober
11	November
12	Desember

wDayOfWeek

Hari dalam seminggu. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Hari Minggu
1	Senin
2	Selasa
3	Rabu
4	Kamis
5	Jumat
6	Sabtu

wDay

Hari dalam sebulan. Nilai yang valid untuk anggota ini adalah 1 hingga 31.

wHour

Jamnya. Nilai yang valid untuk anggota ini adalah 0 hingga 23.

wMinute

Menitnya. Nilai yang valid untuk anggota ini adalah 0 hingga 59.

wSecond

Yang kedua. Nilai yang valid untuk anggota ini adalah 0 hingga 59.

wMilliseconds

Milidetik. Nilai yang valid untuk anggota ini adalah 0 hingga 999.

Keterangan

Catatan

SYSTEMTIME tidak memeriksa untuk melihat apakah tanggal yang diwakili adalah tanggal nyata dan valid. Saat bekerja dengan API ini, Anda harus memastikan validitasnya, terutama dalam skenario tahun kabisat. Lihat kesiapan hari kampung untuk informasi selengkapnya.

Tidak disarankan agar Anda menambahkan dan mengurangi nilai dari struktur SYSTEMTIME untuk mendapatkan waktu relatif. Sebagai gantinya, Anda harus

Mengonversi struktur SYSTEMTIME menjadi struktur FILETIME .
Salin struktur FILETIME yang dihasilkan ke struktur ULARGE_INTEGER .
Gunakan aritmatika normal 64-bit pada nilai ULARGE_INTEGER .

Sistem dapat secara berkala menyegarkan waktu dengan menyinkronkan dengan sumber waktu. Karena waktu sistem dapat disesuaikan baik ke depan atau mundur, jangan bandingkan pembacaan waktu sistem untuk menentukan waktu yang berlalu. Sebagai gantinya, gunakan salah satu metode yang dijelaskan dalam Windows Time.

Contoh

Contoh berikut menunjukkan perbedaan antara nilai waktu yang diambil oleh fungsi GetSystemTime dan GetLocalTime .

#include <windows.h>
#include <stdio.h>

void main()
{
    SYSTEMTIME st, lt;
    
    GetSystemTime(&st);
    GetLocalTime(&lt);
    
    printf("The system time is: %02d:%02d\n", st.wHour, st.wMinute);
    printf(" The local time is: %02d:%02d\n", lt.wHour, lt.wMinute);
}

// Sample output

The system time is: 19:34
 The local time is: 12:34

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Header	minwinbase.h (termasuk Windows.h)