Fungsi GetTimeZoneInformationForYear (timezoneapi.h)

Mengambil pengaturan zona waktu untuk tahun dan zona waktu yang ditentukan. Pengaturan ini mengontrol terjemahan antara Waktu Universal Terkoordinasi (UTC) dan waktu setempat.

Sintaks

BOOL GetTimeZoneInformationForYear(
  [in]           USHORT                         wYear,
  [in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  [out]          LPTIME_ZONE_INFORMATION        ptzi
);

Parameter

[in] wYear

Tahun di mana pengaturan zona waktu akan diambil. Parameter wYear harus berupa nilai waktu lokal.

[in, optional] pdtzi

Penunjuk ke struktur DYNAMIC_TIME_ZONE_INFORMATION yang menentukan zona waktu. Untuk mengisi parameter ini, panggil EnumDynamicTimeZoneInformation dengan indeks zona waktu yang Anda inginkan. Jika parameter ini NULL, zona waktu saat ini digunakan.

[out] ptzi

Penunjuk ke struktur TIME_ZONE_INFORMATION yang menerima pengaturan zona waktu.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Parameter wYear diasumsikan sebagai nilai waktu lokal. Jika waktu lokal mendekati transisi antara tahun lama dan tahun baru (00:00:00 1 Januari), melewati tahun UTC ke fungsi GetTimeZoneInformationForYear dapat menyebabkan fungsi mengembalikan pengaturan zona waktu untuk tahun yang salah.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista dengan SP1 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	timezoneapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

DYNAMIC_TIME_ZONE_INFORMATION

Waktu Lokal

TIME_ZONE_INFORMATION

Fungsi Waktu