Share via

struktur TIME_ZONE_INFORMATION (timezoneapi.h)

  • Artikel

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. 
typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;
 

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

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

SYSTEMTIME

SetTimeZoneInformation