Fungsi GetTimeZoneInformation (timezoneapi.h)

Artikel
03/02/2024

Mengambil pengaturan zona waktu saat ini. Pengaturan ini mengontrol terjemahan antara Waktu Universal Terkoordinasi (UTC) dan waktu setempat.

Untuk mendukung batasan waktu musim panas yang berubah dari tahun ke tahun, gunakan fungsi GetDynamicTimeZoneInformation atau GetTimeZoneInformationForYear .

Sintaks

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Parameter

[out] lpTimeZoneInformation

Penunjuk ke struktur TIME_ZONE_INFORMATION untuk menerima pengaturan saat ini.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan salah satu nilai berikut.

Mengembalikan kode/nilai	Deskripsi
TIME_ZONE_ID_UNKNOWN 0	Waktu musim panas tidak digunakan di zona waktu saat ini, karena tidak ada tanggal transisi atau penyesuaian otomatis untuk waktu musim panas dinonaktifkan.
TIME_ZONE_ID_STANDARD 1	Sistem ini beroperasi dalam rentang yang dicakup oleh anggota StandardDate dari struktur TIME_ZONE_INFORMATION .
TIME_ZONE_ID_DAYLIGHT 2	Sistem beroperasi dalam rentang yang dicakup oleh anggota DaylightDate dari struktur TIME_ZONE_INFORMATION .

Jika fungsi gagal karena alasan lain, seperti kesalahan kehabisan memori, fungsi akan mengembalikan TIME_ZONE_ID_INVALID. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Semua terjemahan antara waktu UTC dan waktu setempat didasarkan pada rumus berikut:

UTC = waktu lokal + bias

Bias adalah perbedaannya, dalam hitungan menit, antara waktu UTC dan waktu setempat.

Anggota StandardName dan DaylightName dari struktur TIME_ZONE_INFORMATION yang dihasilkan dilokalkan sesuai dengan bahasa UI default pengguna saat ini.

Contoh

Misalnya, lihat SetTimeZoneInformation.

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]
Target Platform	Windows
Header	timezoneapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll