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