Bagikan melalui


Struktur SYSTEMTIME (minwinbase.h)

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

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)

Lihat juga

FILETIME

FileTimeToSystemTime

GetLocalTime

GetSystemTime

SetLocalTime

SetSystemTime

SystemTimeToFileTime

ULARGE_INTEGER