Função da biblioteca C - localtime ()

Descrição

A função da biblioteca C struct tm *localtime(const time_t *timer) usa o tempo apontado por timer para preencher um tmestrutura com os valores que representam a hora local correspondente. O valor detimer está dividido na estrutura tm e expresso no fuso horário local.

Declaração

A seguir está a declaração da função localtime ().

struct tm *localtime(const time_t *timer)

Parâmetros

  • timer - Este é o ponteiro para um valor time_t que representa uma hora do calendário.

Valor de retorno

Esta função retorna um ponteiro para um tm estrutura com as informações de tempo preenchidas. A seguir estão as informações da estrutura 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             */	
};

Exemplo

O exemplo a seguir mostra o uso da função 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);
}

Vamos compilar e executar o programa acima que produzirá o seguinte resultado -

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