time.h

time.h è l'header file della libreria standard del C che fornisce un accesso standardizzato alle funzioni di acquisizione e manipolazione del tempo. Fornisce supporto per ottenere il tempo, trasformarlo in diversi formati e convertirlo in stringa.

Funzioni

Tipologia	Nome	Descrizione
Manipolazione dell'ora	difftime	Calcola la differenza in secondi di due valori time_t
	time	Restituisce l'ora del sistema sotto forma di time_tin secondi (che corrispondono solitamente ai secondi dall'epoca, tipicamente dall'epoca unix). Il valore dell'epoca dipende dal sistema operativo. Vengono spesso usati il 1970 e il 1900 come epoca
	clock	Restituisce il numero di tick passati a partire dal lancio del programma
	timespec_get(C11)	Restituisce la data in secondi e millisecondi da una base
Conversione di formati	asctime	Converte una struct tm in una rappresentazione testuale (obsoleta)
	ctime	Converte un valore time_t in una rappresentazione testuale
	strftime	Converte una struct tm in una rappresentazione testuale personalizzata
	strptime	Converte una stringa contenente l'ora in una struct tm
	wcsftime	Converte una struct tm in una rappresentazione testuale personalizzata usando wide string
	gmtime	Converte un valore time_t in ora basata sul calendario espressa come ora UTC
	localtime	Converte un valore time_t in ora basata sul calendario espressa come ora locale
	mktime	Converte l'ora basato sul calendario in time_t

Costanti

Nome	Descrizione
CLOCKS_PER_SEC	Definisce il numero di "tick" della CPU che trascorrono in un secondo. clock()/CLOCKS_PER_SEC risulta quindi essere un tempo espresso in secondi.

Tipi di dato

Nome	Descrizione
clock_t	Tipo di dato restituito da clock(). Generalmente definito come un long int.
time_t	Tipo di dato restituito da time(), rappresenta un tempo di calendario. Generalmente definito come un long int.
struct tm	Struttura usata e restituita da asctime(), gmtime(), localtime() e mktime().
struct timespec	Struttura usata da timespec_get(). Contiene una data composta dal numero di secondi e nanosecondi.

Esempio

Il programma in c qui sotto stampa sullo standard output l'ora corrente:

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

int main(void)
{
    time_t ora_corrente;
    char* stringa_ora_corrente;

    /* Otteniamo l'ora corrente. */
    ora_corrente = time(NULL);

    if (ora_corrente == ((time_t)-1))
    {
        (void) fprintf(stderr, "Errore nell'ottenimento dell'ora corrente.\n");
        exit(EXIT_FAILURE);
    }

    /* Convertiamola nell'ora locale. */
    stringa_ora_corrente = ctime(&ora_corrente);

    if (stringa_ora_corrente == NULL)
    {
        (void) fprintf(stderr, "Errore nella conversione in ora locale.\n");
        exit(EXIT_FAILURE);
    }

    /* Stampiamola sullo standard output. ctime() ha già aggiunto il carattere di ritorno a capo. */
    (void) printf("L'ora corrente è %s", stringa_ora_corrente);
    exit(EXIT_SUCCESS);
}

L'output è il seguente:

L'ora corrente è Sat Sep 16 18:24:29 2023

Altri progetti

Altri progetti

• Wikibooks

• Wikibooks contiene testi o manuali su time.h

Collegamenti esterni

• (EN) time.h da The Open Group Base Specifications Issue 7
• (EN) The GNU C Library - Date and Time, su chemie.fu-berlin.de. URL consultato il 3 luglio 2012 (archiviato dall'url originale il 26 dicembre 2012).
• (EN) C Time Library, su cplusplus.com. URL consultato il 3 luglio 2012 (archiviato dall'url originale il 4 luglio 2012).
• 69.16 File «time.h» da Appunti di informatica libera