Fungsi GetTimeZoneInformation (timezoneapi.h)
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 |
---|---|
|
Waktu musim panas tidak digunakan di zona waktu saat ini, karena tidak ada tanggal transisi atau penyesuaian otomatis untuk waktu musim panas dinonaktifkan. |
|
Sistem ini beroperasi dalam rentang yang dicakup oleh anggota StandardDate dari struktur TIME_ZONE_INFORMATION . |
|
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk