Fonctions système Linux de gestion du temps


Types

time_t
Fonctions
time()


 

time()

Nom
time - récupère la date courante (en secondes)
Syntaxe
 
#include <time.h> // contient le prototype de la fonction time() et
                  //   permet d'accéder au type time_t

time_t time (time_t * t);

Description

    Si le pointeur t est non nul, la fonction time() remplit la zone mémoire pointée par t avec le nombre de secondes écoulées depuis le 1er janvier 1970 à  00h  00m  00s GMT.

    Le type time_t est un entier signé suffisamment grand pour contenir n'importe quelle date valide.

Valeur retournée

    La fonction time() renvoie la valeur dont elle a initialisé la zone mémoire pointée t. Elle peut donc être utilisée soit comme une fonction, soit comme une procédure.

Diagnostic d'erreur

    La fonction time() renvoie -1 en cas d'erreur (seul cas possible : adresse pointée par t invalide) et positionne la variable globale errno.

Exemples d'utilisation

    En C++, la fonction time() et le type time_t appartiennent à l'espace de noms std et sont accessibles au moyen du fichier inclus <ctime> :
 
#include <ctime>      // time_t, time()

#include <unistd.h>   // sleep()

// ...

std::time_t t;
cout << "date : " << std::time (&t) << endl; // date : 981976247

::sleep (1);
cout << "date : " << t; << endl;             // date : 981976247

::sleep (1)
cout << "date : " << std::time (0) << endl;  // date : 981976249

::sleep (1);
std::time (&t);
cout << "date : " << t << endl;              // date : 981976250