CKTIS / C
gmtime — fonction temporelle C23
`gmtime(timer)` de `<time.h>` convertit la valeur de temps calendaire `time_t` désignée en UTC décomposée dans un objet `struct tm`. Elle renvoie un pointeur vers le résultat, ou null si UTC est indisponible ou la valeur irreprésentable.
Version : C23
Syntaxe
struct tm *gmtime(const time_t *timer);gmtime(timer) de <time.h> convertit la valeur de temps calendaire time_t désignée en UTC décomposée dans un objet struct tm. Elle renvoie un pointeur vers le résultat, ou null si UTC est indisponible ou la valeur irreprésentable.
L’exemple passe un time_t nul et, dans l’environnement à époque Unix, affiche 1970-01-01 4 0 : date, jeudi avec tm_wday == 4 et premier jour de l’année avec tm_yday == 0. C ne définit pas le sens numérique de zéro time_t ; cette date appartient à la plate-forme de l’exemple.
Le résultat peut désigner un objet statique partagé qu’un prochain gmtime ou localtime écrase. Copiez les champs utiles et synchronisez les threads ; C23 fournit aussi gmtime_r. tm_mon et tm_yday partent de zéro, tm_year de 1900 et tm_isdst vaut zéro en UTC. Testez toujours null avant déréférencement.
Exemples
#include <stdio.h>
#include <time.h>
int main(void){time_t value=(time_t)0;struct tm *utc=gmtime(&value);if(!utc)return 1;printf("%04d-%02d-%02d %d %d\n",utc->tm_year+1900,utc->tm_mon+1,utc->tm_mday,utc->tm_wday,utc->tm_yday);return 0;}
Résultat
1970-01-01 4 0
L’exemple passe un `time_t` nul et, dans l’environnement à époque Unix, affiche `1970-01-01 4 0` : date, jeudi avec `tm_wday == 4` et premier jour de l’année avec `tm_yday == 0`. C ne définit pas le sens numérique de zéro `time_t` ; cette date appartient à la plate-forme de l’exemple.