Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

time — ottenere l’ora di calendario corrente

La funzione time di <time.h> restituisce un’approssimazione dell’ora di calendario corrente come time_t; controlla che il risultato non sia (time_t)(-1).

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <time.h>
time_t time(time_t *timer);

time restituisce la migliore approssimazione dell’ora di calendario corrente disponibile nell’implementazione. Se l’ora non è disponibile, restituisce (time_t)(-1). Controlla questo risultato prima di usare il valore.

La chiamata time(NULL) restituisce soltanto il risultato. Con un puntatore non nullo, come in time(&stored), la funzione memorizza anche il valore restituito nell’oggetto time_t puntato.

La codifica dell’ora non è specificata: il codice portabile non può presumere che si tratti di secondi dall’epoca Unix. L’esempio confronta il valore memorizzato con quello restituito, invece di stampare una data che cambia.

Esempi

#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t stored;
    time_t result = time(&stored);

    if (result == (time_t)(-1)) {
        puts("Time unavailable");
        return 1;
    }

    puts(stored == result ? "Values match" : "Values differ");
    return 0;
}

Risultato

Values match

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.

Fonti