C Standard Library: <time.h>
Lun 23 Feb 2009
   


#define CLOCKS_PER_SEC <integer constant expression > 0>
#define NULL <0, 0L, or (void *)0>

typedef a-type clock_t;
typedef ui-type size_t;
typedef a-type time_t;
struct tm;

char *asctime(const struct tm *tptr);
clock_t clock(void);
char *ctime(const time_t *tod);
double difftime(time_t t1, time_t t0);
struct tm *gmtime(const time_t *tp);
struct tm *localtime(const time_t *tp);
time_t mktime(struct tm *tp);
size_t strftime(char *s, size_t n, const char *format, const struct tm *tp);
time_t time(time_t *tp);



Definisce il numero di "tick" della CPU in un secondo.
Il valore restituito dalla funzione clock diviso per CLOCKS_PER_SEC è espresso in secondi.
Null pointer constant.
 

È un tipo di dato definito in time.h. In genere è un long int.
È un tipo di dato definito in time.h. In genere è un long int.
La struttura tm contiene informazioni sul tempo, data e ora. Deve contenere almeno i campi

  1. struct tm
  2. {
  3. int tm_sec; /* secondi (0-59) */
  4. int tm_min; /* minuti (0-59) */
  5. int tm_hour; /* ora (0-23) */
  6. int tm_mday; /* giorno del mese (1-31) */
  7. int tm_mon; /* mese dell'anno (0-11) */
  8. int tm_year; /* anno dal 1900 */
  9. int tm_wday; /* giorno della settimana (0-6) */
  10. int tm_yday; /* giorno dell'anno (0-365) */
  11. int tm_isdst; /* Ora legale. Se è in vigore tm_isdst > 0, se non è in vigore tm_isdst = 0,
  12. se non ci sono informazioni tm_isdst < 0. */
  13. }

char*   asctime(const struct tm* tp);
Converte la struttura tm in una stringa della forma seguente: "Mon Feb 23 12:10:19 2009\n\0".
clock_t   clock(void);
Restituisce il numero di "tick" della CPU dall'inizio del programma. Se non è in grado di determinare il numero di "tick" restituisce -1 convertito nel tipo clock_t.
char*   ctime(const time_t* tp);
Converte il "calendar time" in una stringa della forma seguente: "Mon Feb 23 12:10:19 2009\n\0". ctime è equivalente a asctime(localtime(tp)).
double   difftime(time_t time2, time_t time1);
Restituisce la differenza tra due orari, time1 e time2. Sottrae time2 da time1 e converte il risultato in secondi.
struct tm*   gmtime(const time_t* tp);
Converte il "Calendar time" in "Universal coordinate time" (UTC). Se non è possibile calcolare l'Universal coordinate time restituisce NULL.
time_t   mktime(struct tm* tp);
Converte una struttura tm in un "calendar time". Se non è possibile convertire la struttura tm in un "calendar time" restituisce -1 convertito nel tipo time_t.
struct tm*   localtime(const time_t* tp);
Converte il "calendar time" in "local time".
size_t   strftime(char* s, size_t smax, const char* fmt, const struct tm* tp);
Formatta il "calendar time" tp in accordo con la stringa di formato fmt producendo la stringa s. Con smax si indica il numero massimo di caratteri che possono essere scritti in s.
Restituisce il numero di caratteri scritti in s se questo numero è inferiore o uguale a smax. Se è superiore restituisce zero.
Le specifiche di conversione accettate da strftime sono
  • A nome locale del giorno della settimana completo
  • a nome locale del giorno della settimana abbreviato
  • B nome locale del mese completo
  • b nome locale del mese abbreviato
  • c rappresentazione di ora e giorno secondo la località corrente
  • d giorno del mese [01-31]
  • H Ora [00-23]
  • I Ora [01-12]
  • j giorno dell'anno [001-366]
  • M minuto [00-59]
  • m mese [01-12]
  • p modo locale per definire "AM" o "PM"
  • S secondo [00-61]
  • U numero della settimana dell'anno (Domenica viene considerato primo giorno della settimana) [00-53]
  • W numero della settimana dell'anno (Lunedì viene considerato primo giorno della settimana) [00-53]
  • w giorno della settimana (Domenica = 0) [0-6]
  • X rappresentazione dell'ora nella località corrente
  • x rappresentazione della data nella località corrente
  • Y anno, compreso il secolo
  • y anno, senza il secolo [00-99]
  • Z nome del fuso orario locale. Se non si può determinare stampa la stringa nulla.
time_t   time(time_t* tp);
Restituisce il "calendar time" corrente. Se tp ha un valore diverso da NULL il "calendar time" corrente viene restituito anche in tp. Se il "calendar time" non è disponibile viene restituito -1 convertito nel tipo time_t.