Fonction ctime

Entête à  inclure

#include <time.h>  // <ctime> en C++

Fonction ctime

char * ctime( const time_t * pTime );

Cette fonction permet de convertir un timestamp de type time_t, contenant des informations de date et d'heure en une chaîne de caractères C au format « Www Mmm dd hh:mm:ss yyyy ». Cette chaîne sera exprimer en rapport au fuseau horaire local et non en temps UTC (Coordinated Universal Time).

Un appel à cette fonction équivaut à exécuter le code suivant : asctime( localtime( pTime ) );

Vous ne pouvez pas changer le format d'afficher via cette fonction. Préférez l'utilisation de la fonction strftime si vous souhaiter contrôler le formatage de la chaîne.

Paramètre

  • pTime : un pointeur timestamp de type time_t.

Valeur de retour

Cette fonction renvoie une chaîne de caractères (un pointeur) associée à la date et à l'heure considérées. La zone de mémoire associée est préallouée par la librairie <time.h> : vous ne devez en aucun cas désallouer cet espace mémoire via un appel à free après exploitation de la chaîne.

Exemple de code

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

int main( int argc, char * argv[] ) {

    time_t timestamp = time( NULL );
    printf( "Date and local time : %s\n", ctime( & timestamp ) );
            
    return 0;
}

Fonctions et types connexes