Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

localtime — fonction temporelle C23

`localtime(timer)` de `<time.h>` convertit le `time_t` indiqué en temps civil local décomposé et renvoie un pointeur vers `struct tm` ; elle applique les règles de fuseau et d’heure d’été de l’environnement. Elle peut renvoyer null en cas d’échec.

Version : C23

Syntaxe

struct tm *localtime(const time_t *timer);

localtime(timer) de <time.h> convertit le time_t indiqué en temps civil local décomposé et renvoie un pointeur vers struct tm ; elle applique les règles de fuseau et d’heure d’été de l’environnement. Elle peut renvoyer null en cas d’échec.

L’exemple passe un time_t nul à localtime et contrôle le pointeur ainsi que les plages mois, jour, heure, minute et seconde. Il affiche 1 dans l’environnement sans supposer un fuseau précis.

Le résultat pointe vers un objet statique qu’un autre localtime, gmtime ou ctime peut écraser ; copiez aussitôt la struct tm. Les appels concurrents ne sont pas garantis sûrs. tm_isdst peut être positif, nul ou négatif ; les heures locales ambiguës ou inexistantes aux transitions DST demandent prudence avec mktime.

Exemples

#include <stdio.h>
#include <time.h>
int main(void){time_t raw=0;struct tm *v=localtime(&raw);int ok=v&&v->tm_mon>=0&&v->tm_mon<=11&&v->tm_mday>=1&&v->tm_mday<=31&&v->tm_hour>=0&&v->tm_hour<=23&&v->tm_min>=0&&v->tm_min<=59&&v->tm_sec>=0&&v->tm_sec<=60;printf("%d\n",ok);return 0;}

Résultat

1

L’exemple passe un `time_t` nul à `localtime` et contrôle le pointeur ainsi que les plages mois, jour, heure, minute et seconde. Il affiche `1` dans l’environnement sans supposer un fuseau précis.

Sources