Funzione SystemTimeToTzSpecificLocalTime (timezoneapi.h)
Converte un'ora nell'ora UTC (Coordinated Universal Time) nell'ora locale corrispondente di un fuso orario specificato.
Sintassi
BOOL SystemTimeToTzSpecificLocalTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpUniversalTime,
[out] LPSYSTEMTIME lpLocalTime
);
Parametri
[in, optional] lpTimeZoneInformation
Puntatore a una struttura TIME_ZONE_INFORMATION che specifica il fuso orario di interesse.
Se lpTimeZone è NULL, la funzione usa il fuso orario attualmente attivo.
[in] lpUniversalTime
Puntatore a una struttura SYSTEMTIME che specifica l'ora UTC da convertire. La funzione converte questa ora universale nell'ora locale corrispondente del fuso orario specificato.
[out] lpLocalTime
Puntatore a una struttura SYSTEMTIME che riceve l'ora locale.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero e la funzione imposta i membri della struttura SYSTEMTIME a cui punta lpLocalTime sui valori di ora locale appropriati.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione SystemTimeToTzSpecificLocalTime tiene conto se l'ora legale (DST) è attiva per l'ora locale in cui deve essere convertita l'ora di sistema.
La funzione SystemTimeToTzSpecificLocalTime può calcolare erroneamente l'ora locale in base alle condizioni seguenti:
- Il fuso orario usa un offset UTC diverso per i vecchi e i nuovi anni.
- L'ora UTC da convertire e l'ora locale calcolata si trovano in anni diversi.
Esempio
Per un esempio, vedere Recupero dell'ora di Last-Write.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | timezoneapi.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |