CKTIS / C
mktime — convertire e normalizzare l’ora locale
mktime converte in time_t l’ora locale memorizzata in una struct tm e, in caso di successo, ne normalizza i campi.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <time.h>
time_t mktime(struct tm *timeptr);mktime di <time.h> accetta un puntatore a una struct tm modificabile. Interpreta l’ora come locale, non come UTC; time_t non deve necessariamente codificare secondi Unix.
tm_year conta gli anni a partire dal 1900 e tm_mon i mesi a partire da 0. I campi possono superare i rispettivi intervalli abituali. In caso di successo, la funzione normalizza la struttura e calcola tm_wday e tm_yday, i cui valori iniziali vengono ignorati.
tm_isdst: un valore positivo indica l’ora legale, zero indica che non è in vigore e un valore negativo ne richiede il rilevamento. Per le ore saltate o ripetute durante i cambi dell’ora, la scelta non è specificata.
Il risultato è un time_t; un’ora non rappresentabile produce (time_t)-1. La normalizzazione non è una convalida rigorosa della data.
Esempi
#include <stdio.h>
#include <time.h>
int main(void)
{
struct tm t = {0};
t.tm_year = 2024 - 1900;
t.tm_mon = 0;
t.tm_mday = 32;
t.tm_hour = 12;
t.tm_isdst = -1;
if (mktime(&t) == (time_t)-1) {
puts("conversion failed");
return 1;
}
printf("%04d-%02d-%02d\n",
t.tm_year + 1900, t.tm_mon + 1, t.tm_mday);
return 0;
}Risultato
2024-02-01
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.