Fungsi SystemTimeToTzSpecificLocalTime (timezoneapi.h)
Mengonversi waktu dalam Waktu Universal Terkoordinasi (UTC) ke waktu lokal zona waktu tertentu yang sesuai.
Sintaks
BOOL SystemTimeToTzSpecificLocalTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpUniversalTime,
[out] LPSYSTEMTIME lpLocalTime
);
Parameter
[in, optional] lpTimeZoneInformation
Penunjuk ke struktur TIME_ZONE_INFORMATION yang menentukan zona waktu yang diminati.
Jika lpTimeZone adalah NULL, fungsi menggunakan zona waktu yang saat ini aktif.
[in] lpUniversalTime
Penunjuk ke struktur SYSTEMTIME yang menentukan waktu UTC untuk dikonversi. Fungsi ini mengonversi waktu universal ini ke waktu lokal yang sesuai dengan zona waktu yang ditentukan.
[out] lpLocalTime
Penunjuk ke struktur SYSTEMTIME yang menerima waktu setempat.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol, dan fungsi mengatur anggota struktur SYSTEMTIME yang ditujukkan oleh lpLocalTime ke nilai waktu lokal yang sesuai.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi SystemTimeToTzSpecificLocalTime memperhitungkan apakah waktu musim panas (DST) berlaku untuk waktu lokal tempat waktu sistem akan dikonversi.
Fungsi SystemTimeToTzSpecificLocalTime dapat menghitung waktu lokal dengan salah dalam kondisi berikut:
- Zona waktu menggunakan offset UTC yang berbeda untuk tahun-tahun lama dan baru.
- Waktu UTC untuk dikonversi dan waktu lokal yang dihitung berada dalam tahun yang berbeda.
Contoh
Misalnya, lihat Mengambil Waktu Last-Write.
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