Función de biblioteca C - mktime ()

Descripción

La función de la biblioteca C time_t mktime(struct tm *timeptr) convierte la estructura apuntada por timeptr en un valor time_t según la zona horaria local.

Declaración

A continuación se muestra la declaración de la función mktime ().

time_t mktime(struct tm *timeptr)

Parámetros

  • timeptr- Este es el puntero a un valor de time_t que representa un tiempo del calendario, desglosado en sus componentes. A continuación se muestra el detalle de la estructura 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             */	
};

Valor devuelto

Esta función devuelve un valor time_t correspondiente al tiempo del calendario pasado como argumento. En caso de error, se devuelve un valor -1.

Ejemplo

El siguiente ejemplo muestra el uso de la función 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); } 
       
      

Compilemos y ejecutemos el programa anterior que producirá el siguiente resultado:

Wed Jul 4 00:00:01 2001