localtime ()- Convertir hora

Formato

#include <time.h>
struct tm *localtime(const time_t *timeval);

Nivel de idioma

ANSI

De hebra segura

En su lugar, utilice localtime_r() .

Sensible al entorno local

El comportamiento de esta función puede verse afectado por la categoría LC_TOD del entorno local actual.

Descripción

La función localtime() convierte un valor de tiempo, en segundos, en una estructura de tipo tm.

La función localtime() toma un valor de timeval que se presupone que es UTC (Universal Coordinate Time) y lo convierte a la hora del entorno local del trabajo. Para esta conversión, localtime() comprueba el valor de entorno local actual para el huso horario local y el horario de verano (DST). Si estos valores no se establecen en el entorno local actual, localtime() obtiene los valores de huso horario local y horario de verano (DST) del trabajo actual. Una vez convertida, la hora se devuelve en una estructura de tipo tm. Si el DST está establecido en el entorno local pero la información de huso horario no lo está, la información del DST en el entorno local se ignora.

El valor de hora normalmente se obtiene mediante una llamada a la función time() .

Nota:

Las funciones gmtime() y localtime() pueden utilizar un almacenamiento intermedio común asignado estáticamente para la conversión. Cada llamada a una de estas funciones puede destruir el resultado de la llamada anterior. Las funciones ctime_r(), gmtime_r()y localtime_r() no utilizan un almacenamiento intermedio común asignado estáticamente. Estas funciones se pueden utilizar en lugar de las funciones asctime(), ctime(), gmtime() y localtime() si se desea volver a entrar.
El tiempo de calendario es el número de segundos que han transcurrido desde EPOCH, que es 00:00:00, 1 de enero de 1970, hora universal coordinada (UTC).

Valor de retorno

La función localtime() devuelve un puntero al resultado de la estructura. No hay ningún valor de retorno de error.

Ejemplo

Este ejemplo consulta el reloj del sistema y muestra la hora local.

#include <time.h>
#include <stdio.h>
 
int main(void)
{
   struct tm *newtime;
   time_t ltime;
 
   ltime = time(&ltime);
   newtime = localtime(&ltime);
   printf("The date and time is %s", asctime(newtime));}
 
/**************  If the local time is 3 p.m. February 15, 2008, **********
*************************  the output should be:  *********************
 
The date and time is Fri Feb 15 15:00:00 2008
*/