Fonction de bibliothèque C - asctime ()

La description

La fonction de bibliothèque C char *asctime(const struct tm *timeptr) renvoie un pointeur vers une chaîne qui représente le jour et l'heure de la structure struct timeptr.

Déclaration

Voici la déclaration de la fonction asctime ().

char *asctime(const struct tm *timeptr)

Paramètres

le timeptr est un pointeur vers la structure tm qui contient une heure calendaire décomposée en ses composants comme indiqué ci-dessous -

struct tm {
   int tm_sec;         /* seconds,  range 0 to 59          */
   int tm_min;         /* minutes, range 0 to 59           */
   int tm_hour;        /* hours, range 0 to 23             */
   int tm_mday;        /* day of the month, range 1 to 31  */
   int tm_mon;         /* month, range 0 to 11             */
   int tm_year;        /* The number of years since 1900   */
   int tm_wday;        /* day of the week, range 0 to 6    */
   int tm_yday;        /* day in the year, range 0 to 365  */
   int tm_isdst;       /* daylight saving time             */
};

Valeur de retour

Cette fonction renvoie une chaîne C contenant les informations de date et d'heure dans un format lisible par l'homme Www Mmm dd hh:mm:ss yyyy, où Www est le jour de la semaine, Mmm le mois en lettres, jj le jour du mois, hh: mm: ss l'heure et aaaa l'année.

Exemple

L'exemple suivant montre l'utilisation de la fonction asctime ().

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

int main () {
   struct tm t;

   t.tm_sec    = 10;
   t.tm_min    = 10;
   t.tm_hour   = 6;
   t.tm_mday   = 25;
   t.tm_mon    = 2;
   t.tm_year   = 89;
   t.tm_wday   = 6;

   puts(asctime(&t));
   
   return(0);
}

Compilons et exécutons le programme ci-dessus qui produira le résultat suivant -

Sat Mar 25 06:10:10 1989