Fonction asctime

Entête à  inclure

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

Fonction asctime

char * asctime( const struct tm * pTime );

Cette fonction permet de convertir une structure de type struct tm, 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 ». 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 constant sur une structure de type struct tm contenant les informations de date et d'heure.

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 );
    struct tm * timeInfos = localtime( & timestamp );

    printf( "Date and local time : %s\n", asctime( timeInfos ) );
            
    return 0;
}

Et voici le résultat produit par cet exemple.

$> gcc -o Sample Sample.c
$> ./Sample
Date and local time : Sat Nov 22 20:38:19 2014

$> 

Fonctions et types connexes