Función de biblioteca C - localtime ()

Descripción

La función de la biblioteca C struct tm *localtime(const time_t *timer) usa el tiempo señalado por timer para llenar un tmestructura con los valores que representan la hora local correspondiente. El valor detimer se divide en la estructura tm y expresado en la zona horaria local.

Declaración

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

struct tm *localtime(const time_t *timer)

Parámetros

  • timer - Este es el puntero a un valor de time_t que representa un tiempo del calendario.

Valor devuelto

Esta función devuelve un puntero a un tm estructura con la información de tiempo completa. A continuación se muestra la información de estructura tm:

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             */	
};

Ejemplo

El siguiente ejemplo muestra el uso de la función localtime ().

#include <stdio.h>
#include <time.h>
int main () {
   time_t rawtime;
   struct tm *info;
   time( &rawtime );
   info = localtime( &rawtime );
   printf("Current local time and date: %s", asctime(info));
   return(0);
}

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

Current local time and date: Thu Aug 23 09:12:05 2012