Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

gmtime — funzione temporale C23

`gmtime(timer)` di `<time.h>` converte il valore di tempo di calendario `time_t` indicato in UTC scomposto dentro un oggetto `struct tm`. Restituisce un puntatore al risultato, o null se UTC non è disponibile o il valore non è rappresentabile.

Versione: C23

Sintassi

struct tm *gmtime(const time_t *timer);

gmtime(timer) di <time.h> converte il valore di tempo di calendario time_t indicato in UTC scomposto dentro un oggetto struct tm. Restituisce un puntatore al risultato, o null se UTC non è disponibile o il valore non è rappresentabile.

L’esempio passa un time_t zero e, nell’ambiente con epoca Unix, stampa 1970-01-01 4 0: data, giovedì come tm_wday == 4 e primo giorno dell’anno come tm_yday == 0. C non definisce il significato numerico dello zero time_t, quindi la data appartiene alla piattaforma d’esempio.

Il risultato può indicare un oggetto statico condiviso sovrascritto da successive gmtime o localtime. Copia i campi e sincronizza i thread; C23 offre anche gmtime_r. tm_mon e tm_yday partono da zero, tm_year dal 1900 e tm_isdst vale zero per UTC. Controlla sempre null prima di dereferenziare.

Esempi

#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;}

Risultato

1970-01-01 4 0

L’esempio passa un `time_t` zero e, nell’ambiente con epoca Unix, stampa `1970-01-01 4 0`: data, giovedì come `tm_wday == 4` e primo giorno dell’anno come `tm_yday == 0`. C non definisce il significato numerico dello zero `time_t`, quindi la data appartiene alla piattaforma d’esempio.

Fonti