Função da biblioteca C - asctime ()

Descrição

A função da biblioteca C char *asctime(const struct tm *timeptr) retorna um ponteiro para uma string que representa o dia e a hora da estrutura struct timeptr.

Declaração

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

char *asctime(const struct tm *timeptr)

Parâmetros

o timeptr é um ponteiro para a estrutura tm que contém um tempo de calendário dividido em seus componentes, conforme mostrado abaixo -

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 de retorno

Esta função retorna uma string C contendo as informações de data e hora em um formato legível Www Mmm dd hh:mm:ss yyyy, onde Www é o dia da semana, Mmm o mês em letras, dd o dia do mês, hh: mm: ss a hora e aaaa o ano.

Exemplo

O exemplo a seguir mostra o uso da função asctime ().

#include <stdio.h>
#include <string.h>
#include <time.h>

int main () {
   struct tm t;

   t.tm_sec    = 10;
   t.tm_min    = 10;
   t.tm_hour   = 6;
   t.tm_mday   = 25;
   t.tm_mon    = 2;
   t.tm_year   = 89;
   t.tm_wday   = 6;

   puts(asctime(&t));
   
   return(0);
}

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

Sat Mar 25 06:10:10 1989