Fonction de bibliothèque C - mktime ()

La description

La fonction de bibliothèque C time_t mktime(struct tm *timeptr) convertit la structure pointée par timeptr en une valeur time_t en fonction du fuseau horaire local.

Déclaration

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

time_t mktime(struct tm *timeptr)

Paramètres

timeptr- Il s'agit du pointeur vers une valeur time_t représentant une heure calendaire, décomposée en ses composants. Voici le détail de la structure timeptr

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 valeur time_t correspondant à l'heure du calendrier passée en argument. En cas d'erreur, une valeur -1 est renvoyée.

Exemple

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

#include 
#include 

int main () {
   int ret;
   struct tm info;
   char buffer[80];

   info.tm_year = 2001 - 1900;
   info.tm_mon = 7 - 1;
   info.tm_mday = 4;
   info.tm_hour = 0;
   info.tm_min = 0;
   info.tm_sec = 1;
   info.tm_isdst = -1;

   ret = mktime(&info);
   if( ret == -1 ) {
      printf("Error: unable to make time using mktime\n");
   } else {
      strftime(buffer, sizeof(buffer), "%c", &info );
      printf(buffer);
   }

   return(0);
}

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

Wed Jul 4 00:00:01 2001

↰ Previous page