Fungsi TzSpecificLocalTimeToSystemTime (timezoneapi.h)

Mengonversi waktu lokal yang ditentukan ke waktu yang sesuai dalam Waktu Universal Terkoordinasi (UTC).

Syntax

BOOL TzSpecificLocalTimeToSystemTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpLocalTime,
  [out]          LPSYSTEMTIME                lpUniversalTime
);

Parameter-parameternya

[in, optional] lpTimeZoneInformation

Penunjuk ke struktur TIME_ZONE_INFORMATION yang menentukan zona waktu untuk waktu yang ditentukan dalam lpLocalTime.

Jika lpTimeZoneInformation adalah NULL, fungsi menggunakan zona waktu yang saat ini aktif.

[in] lpLocalTime

Penunjuk ke struktur SYSTEMTIME yang menentukan waktu lokal untuk dikonversi. Fungsi ini mengonversi kali ini ke waktu UTC yang sesuai.

[out] lpUniversalTime

Penunjuk ke struktur SYSTEMTIME yang menerima waktu UTC.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian bukan nol, dan fungsi mengatur anggota struktur SYSTEMTIME yang ditunjukkan oleh lpUniversalTime ke nilai yang sesuai.

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

Komentar

TzSpecificLocalTimeToSystemTime memperhitungkan apakah waktu musim panas (DST) berlaku untuk waktu lokal yang akan dikonversi.

Penting

Waktu lokal berikut, di dekat transisi DST, dapat ambigu atau tidak valid dan dapat mengakibatkan perilaku yang tidak terduga (karena tidak ada hasil "benar" yang dijamin).

• Selama transisi dari waktu musim panas ke waktu standar, jam lokal berulang. Waktu lokal dalam jendela berulang bersifat ambigu karena terjadi dua kali, sekali di siang hari menghemat waktu dan sekali dalam waktu standar.
• Selama transisi dari waktu standar ke waktu musim panas, jam lokal melompat ke depan. Waktu lokal dalam jendela yang dilewati tidak valid karena tidak memiliki konversi UTC yang valid.

Jika waktu lokal yang ditentukan ambigu atau tidak valid, fungsi memperlakukannya sebagai waktu musim panas dan menerapkan bias waktu musim panas. Aplikasi yang membutuhkan kelangsungan atau presisi harus menghindari fungsi ini dan menggunakan waktu UTC sebagai gantinya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	timezoneapi.h (termasuk Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetSystemTime

GetTimeZoneInformation

Waktu Lokal

SYSTEMTIME

SystemTimeToTzSpecificLocalTime

TIME_ZONE_INFORMATION

Fungsi Waktu