CKTIS / C
mktime — convertir et normaliser l’heure locale
mktime convertit en time_t l’heure locale stockée dans une struct tm et normalise ses champs en cas de réussite.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <time.h>
time_t mktime(struct tm *timeptr);mktime, déclaré dans <time.h>, accepte un pointeur vers une struct tm modifiable. La fonction interprète l’heure comme une heure locale, et non comme UTC ; time_t n’encode pas nécessairement des secondes Unix.
tm_year compte les années depuis 1900 et tm_mon les mois à partir de 0. Les champs peuvent dépasser leurs plages habituelles. En cas de réussite, la fonction normalise la structure et calcule tm_wday et tm_yday, dont les valeurs fournies en entrée sont d’abord ignorées.
tm_isdst : une valeur positive indique l’heure d’été, zéro son absence et une valeur négative demande sa détection. Pour les heures sautées ou répétées lors des changements d’heure, le choix n’est pas spécifié.
Le résultat est un time_t ; une heure non représentable donne (time_t)-1. La normalisation ne constitue pas une validation stricte de la date.
Exemples
#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;
}Résultat
2024-02-01
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.