struktur TIME_ZONE_INFORMATION (timezoneapi.h)
Menentukan pengaturan untuk zona waktu.
Sintaks
typedef struct _TIME_ZONE_INFORMATION {
LONG Bias;
WCHAR StandardName[32];
SYSTEMTIME StandardDate;
LONG StandardBias;
WCHAR DaylightName[32];
SYSTEMTIME DaylightDate;
LONG DaylightBias;
} TIME_ZONE_INFORMATION, *PTIME_ZONE_INFORMATION, *LPTIME_ZONE_INFORMATION;
Anggota
Bias
Bias saat ini untuk terjemahan waktu lokal pada komputer ini, dalam hitungan menit. Bias adalah perbedaan, dalam menit, antara Waktu Universal Terkoordinasi (UTC) dan waktu setempat. Semua terjemahan antara UTC dan waktu setempat didasarkan pada rumus berikut:
UTC = waktu lokal + bias
Anggota ini diperlukan.
StandardName[32]
Deskripsi untuk waktu standar. Misalnya, "EST" dapat menunjukkan Waktu Standar Timur. String akan dikembalikan tidak berubah oleh fungsi GetTimeZoneInformation . String ini bisa kosong.
StandardDate
Struktur SYSTEMTIME yang berisi tanggal dan waktu lokal ketika transisi dari waktu musim panas ke waktu standar terjadi pada sistem operasi ini. Jika zona waktu tidak mendukung waktu musim panas atau jika pemanggil perlu menonaktifkan waktu musim panas, anggota wMonth dalam struktur SYSTEMTIME harus nol. Jika tanggal ini ditentukan, anggota DaylightDate dari struktur ini juga harus ditentukan.
Jika tidak, sistem mengasumsikan data zona waktu tidak valid dan tidak ada perubahan yang akan diterapkan.
Untuk memilih hari yang benar dalam bulan tersebut, atur anggota wYear ke nol, anggota wHour dan wMinute ke waktu transisi, anggota wDayOfWeek ke hari kerja yang sesuai, dan anggota wDay untuk menunjukkan terjadinya hari dalam seminggu dalam sebulan (1 hingga 5, di mana 5 menunjukkan kejadian akhir selama bulan tersebut jika hari itu dalam seminggu tidak terjadi 5 kali).
Dengan menggunakan notasi ini, tentukan 02:00 pada Hari Minggu pertama pada bulan April sebagai berikut: wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1. Tentukan 02:00 pada Kamis terakhir pada bulan Oktober sebagai berikut: wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5.
Jika anggota wYear bukan nol, tanggal transisi bersifat absolut; itu hanya akan terjadi satu kali. Jika tidak, itu adalah tanggal relatif yang terjadi setiap tahun.
StandardBias
Nilai bias yang akan digunakan selama terjemahan waktu lokal yang terjadi selama waktu standar. Anggota ini diabaikan jika nilai untuk anggota StandardDate tidak disediakan.
Nilai ini ditambahkan ke nilai anggota Bias untuk membentuk bias yang digunakan selama waktu standar. Di sebagian besar zona waktu, nilai anggota ini adalah nol.
DaylightName[32]
Deskripsi untuk siang hari menghemat waktu. Misalnya, "PDT" dapat menunjukkan Waktu Siang Pasifik. String akan dikembalikan tidak berubah oleh fungsi GetTimeZoneInformation . String ini bisa kosong.
DaylightDate
Struktur SYSTEMTIME yang berisi tanggal dan waktu lokal ketika transisi dari waktu standar ke waktu musim panas terjadi pada sistem operasi ini. Jika zona waktu tidak mendukung waktu musim panas atau jika pemanggil perlu menonaktifkan waktu musim panas, anggota wMonth dalam struktur SYSTEMTIME harus nol. Jika tanggal ini ditentukan, anggota StandardDate dalam struktur ini juga harus ditentukan.
Jika tidak, sistem mengasumsikan data zona waktu tidak valid dan tidak ada perubahan yang akan diterapkan.
Untuk memilih hari yang benar dalam bulan tersebut, atur anggota wYear ke nol, anggota wHour dan wMinute ke waktu transisi, anggota wDayOfWeek ke hari kerja yang sesuai, dan anggota wDay untuk menunjukkan terjadinya hari dalam seminggu dalam sebulan (1 hingga 5, di mana 5 menunjukkan kejadian akhir selama bulan tersebut jika hari itu dalam seminggu tidak terjadi 5 kali).
Jika anggota wYear bukan nol, tanggal transisi bersifat absolut; itu hanya akan terjadi satu kali. Jika tidak, itu adalah tanggal relatif yang terjadi setiap tahun.
DaylightBias
Nilai bias yang akan digunakan selama terjemahan waktu lokal yang terjadi selama waktu musim panas. Anggota ini diabaikan jika nilai untuk anggota DaylightDate tidak disediakan.
Nilai ini ditambahkan ke nilai anggota Bias untuk membentuk bias yang digunakan selama waktu musim panas. Di sebagian besar zona waktu, nilai anggota ini adalah –60.
Keterangan
Pengaturan untuk setiap zona waktu disimpan dalam kunci registri berikut:
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows NT CurrentVersion Time Zones time_zone_name
Setiap entri zona waktu menyertakan nilai registri berikut.
Nilai registri | Jenis | Deskripsi |
---|---|---|
Tampilan | REG_SZ | Nama tampilan. |
Dlt | REG_SZ | Deskripsi untuk siang hari. |
MUI_Display | REG_SZ | Nama tampilan sebagai string formulir @path,-stringID[;komentar]. Untuk informasi selengkapnya, lihat MUI. |
MUI_Dlt | REG_SZ | Deskripsi untuk waktu siang hari sebagai string formulir @path,-stringID[;komentar]. |
MUI_Std | REG_SZ | Deskripsi untuk waktu standar sebagai string formulir @path,-stringID[;komentar]. |
Std | REG_SZ | Deskripsi untuk waktu standar. |
TZI | REG_BINARY |
Informasi zona waktu berikut.
|
Untuk informasi selengkapnya tentang kunci DST Dinamis , lihat DYNAMIC_TIME_ZONE_INFORMATION.
StandardName dan DaylightName dilokalkan sesuai dengan bahasa UI default pengguna saat ini.
Contoh
Misalnya, lihat SetTimeZoneInformation.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
Header | timezoneapi.h (termasuk Windows.h) |
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