Namespaces
Variants

time

From cppreference.net
Défini dans l'en-tête <time.h>
time_t time ( time_t * arg ) ;

Retourne l'heure calendaire actuelle encodée sous forme d'un objet time_t , et la stocke également dans l'objet time_t pointé par arg (sauf si arg est un pointeur nul)

Table des matières

Paramètres

arg - pointeur vers un time_t objet où le temps sera stocké, ou un pointeur nul

Valeur de retour

Temps calendaire actuel encodé en tant qu'objet time_t en cas de succès, ( time_t ) ( - 1 ) en cas d'erreur. Si arg n'est pas un pointeur nul, la valeur de retour est également stockée dans l'objet pointé par arg .

Notes

L'encodage du temps calendaire dans time_t n'est pas spécifié, mais la plupart des systèmes se conforment à la spécification POSIX et renvoient une valeur de type intégral contenant le nombre de secondes depuis l'Époque . Les implémentations dans lesquelles time_t est un entier signé de 32 bits (de nombreuses implémentations historiques) échouent en l'année 2038 .

Exemple

#include <stdint.h>
#include <stdio.h>
#include <time.h>
int main(void)
{
    time_t result = time(NULL);
    if (result != (time_t)(-1))
        printf("The current time is %s(%jd seconds since the Epoch)\n",
               asctime(gmtime(&result)), (intmax_t)result);
}

Sortie possible :

The current time is Fri Apr 24 15:05:25 2015
(1429887925 seconds since the Epoch)

Références

  • Norme C23 (ISO/CEI 9899:2024) :
  • 7.27.2.4 La fonction time (p: TBD)
  • Norme C17 (ISO/CEI 9899:2018) :
  • 7.27.2.4 La fonction time (p: 286)
  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.27.2.4 La fonction time (p: 391)
  • Norme C99 (ISO/IEC 9899:1999) :
  • 7.23.2.4 La fonction time (p: 341)
  • Norme C89/C90 (ISO/CEI 9899:1990) :
  • 4.12.2.4 La fonction time

Voir aussi

convertit le temps depuis l'époque en temps calendaire exprimé en heure locale
(fonction)
convertit le temps depuis l'époque en temps calendaire exprimé en temps universel coordonné (UTC)
(fonction)
retourne le temps calendaire en secondes et nanosecondes basé sur une base de temps donnée
(fonction)