BSD
April 26, 1996
Aliases: asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), asctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), ctime_r(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), gmtime_r(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), localtime_r(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3), mktime(3)
manpages-pt-dev
Portuguese Versions of the Manual Pages (dev sections)
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
NOME
asctime, ctime, gmtime, localtime, mktime - convertem datas e horas binárias para ASCII
SINOPSE
#include <time.h>
char *asctime(const struct tm *timeptr);
char *ctime(const time_t *timep);
struct tm *gmtime(const time_t *timep);
struct tm *localtime(const time_t *timep);
time_t mktime(struct tm *timeptr);
extern char *tzname[2]; long int timezone; extern int daylight;
DESCRIÇÃO
As funções ctime(), gmtime() e localtime() recebem um argumento tipo time_t, que representa um ponto no tempo. Quando interpretado como um valor absoluto, representa o número de segundos desde as 00:00:00 de 1 de janeiro de 1970 (Hora Universal Sincronizada - UTC).
A função gmtime() converte o instante timep para a representação detalhada do UTC.
As funções asctime() e mktime() recebem um argumento que representa um instante definido em termos de ano, mês, dia, etc. Este argumento é uma struct tm (definida em <time.h>) que contém:
struct tm { int tm_sec; /* segundos */ int tm_min; /* minuto */ int tm_hour; /* horas */ int tm_mday; /* dia do mês */ int tm_mon; /* mês */ int tm_year; /* ano */ int tm_wday; /* dia da semana */ int tm_yday; /* dia do ano */ int tm_isdst; /* horário de verão */ };
Os componentes do struct tm são
tm_sec | Segundos após o minuto. Normalmente de 0 a 59, mas podendo chegar a 61 no caso de um segundo ser acrescentado. |
tm_min | Minutos depois da hora. De 0 a 59. |
tm_hour | |
Horas após a meia noite. De 0 a 23. | |
tm_mday | |
Dia do mês. De 1 a 31. | |
tm_mon | Meses desde janeiro. De 0 a 11. |
tm_year | |
Anos desde 1900. | |
tm_wday | |
Dias de semana desde domingo. De 0 a 6. | |
tm_yday | |
Dias desde 1 de janeiro. De 0 a 365. | |
tm_isdst | |
Um flag que indica se se está em vigência do horário de verão. É um valor positivo se estiver, zero se não estiver e negativo se esta informação não estiver disponível. | |
A função ctime() converte timep numa string no formato | |
"Wed Jun 30 21:49:08 1993\n"
As abreviaturas dos dias da semana são ‘Sun’, ‘Mon’, ‘Tue’, ‘Wed’, ‘Thu’, ‘Fri’ e ‘Sat’,e as dos meses são ‘Jan’, ‘Feb’, ‘Mar’, ‘Apr’, ‘May’, ‘Jun’, ‘Jul’, ‘Aug’, ‘Sep’, ‘Oct’, ‘Nov’ e ‘Dec’. O valor retornado aponta para uma string alocada estaticamente, e que pode ser sobrescrita por chamadas subseqüentes a quaisquer das funções de data e hora. A função também coloca informação sobre o fuso horário atual na variável externa tzname.
|
A função localtime() converte o instante timep para a representação detalhada UTC, mas corrigida para o fuso horário do usuário. Esta função coloca informações de fuso horário na variável externa tzname, a diferença entre a UTC e a hora local em segundos em timezone e um valor diferente de zero em daylight se o horário de verão estiver em vigor.
A função asctime() converte o valor de tempo timeptr para uma string com o mesmo formato que ctime(). O valor retornado aponta para uma string alocada estaticamente que pode ser sobrescrita por chamadas subseqüentes a quaisquer das funções de data e tempo.
A função mktime() converte uma struct de tempo detalhada, definida como hora local, para um ponto no tempo. Esta função ignora tm_wday e tm_yday, recalculando-os a partir dos outros dados no struct. Os membros serão recalculados se excederem seus valores máximos (ex. 40 de outubro mudará para 9 de novembro). Uma chamada a mktime() também colocará informações sobre o fuso horário em tzname. Se o tempo especificado não puder ser representado no calendário (em segundos desde a Época), mktime() retornará (time_t)(-1) sem alterar os componentes tm_wday e tm_yday do struct.
DE ACORDO COM
SVID 3, POSIX, BSD 4.3, ISO 9899
VER TAMBÉM
TRADUZIDO POR LDP-BR em 21/08/2000.
REFERENCED BY
find(1), clock_getres(2), gettimeofday(2), time(2), difftime(3), strftime(3), strptime(3), tzset(3), tzfile(5), environ(7), time(7), utmpdump(1), date(1plan9), audispd-zos-remote(8), dump(8), convdate(1), pmCtime(3), mgettydefs(4), dp(8mh), dp(8), pmie(1), plotnetcfg-json(5), co(1), rlinetd.conf(5), blame(1), xdaliclock(1), clock_getres(3), clock_gettime(3), clock_settime(3), lde(8), pmNotifyErr(3), mmh-dp(8mh), tm(3ast), tmx(3ast)