Provided by:
manpages-pt-dev_20040726-4_all 
NOME
asctime, ctime, gmtime, localtime, mktime - convertem datas e horas
binarias 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,C~AO
As funcoes ctime(), gmtime() e localtime() recebem um argumento tipo
time_t, que representa um ponto no tempo. Quando interpretado como um
valor absoluto, representa o numero de segundos desde as 00:00:00 de 1
de janeiro de 1970 (Hora Universal Sincronizada - UTC).
As funcoes asctime() e mktime() recebem um argumento que representa um
instante definido em termos de ano, mes, dia, etc. Este argumento e uma
struct tm (definida em <time.h>) que contem:
struct tm
{
int tm_sec; /* segundos */
int tm_min; /* minuto */
int tm_hour; /* horas */
int tm_mday; /* dia do mes */
int tm_mon; /* mes */
int tm_year; /* ano */
int tm_wday; /* dia da semana */
int tm_yday; /* dia do ano */
int tm_isdst; /* horario de verao */
};
Os componentes do struct tm sao
tm_sec Segundos apos 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 apos a meia noite. De 0 a 23.
tm_mday
Dia do mes. 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 esta em vigencia do horario de verao. E
um valor positivo se estiver, zero se nao estiver e negativo se
esta informacao nao estiver disponivel.
A funcao ctime() converte timep numa string no formato
"Wed Jun 30 21:49:08 1993\n"
As abreviaturas dos dias da semana sao `Sun', `Mon', `Tue', `Wed',
`Thu', `Fri' e `Sat',e as dos meses sao `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 subsequentes a quaisquer das funcoes de data e
hora. A funcao tambem coloca informacao sobre o fuso horario atual na
variavel externa tzname.
A funcao gmtime() converte o instante timep para a representacao
detalhada do UTC.
A funcao localtime() converte o instante timep para a representacao
detalhada UTC, mas corrigida para o fuso horario do usuario. Esta
funcao coloca informacoes de fuso horario na variavel externa tzname, a
diferenca entre a UTC e a hora local em segundos em timezone e um valor
diferente de zero em daylight se o horario de verao estiver em vigor.
A funcao 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
subsequentes a quaisquer das funcoes de data e tempo.
A funcao mktime() converte uma struct de tempo detalhada, definida como
hora local, para um ponto no tempo. Esta funcao ignora tm_wday e
tm_yday, recalculando-os a partir dos outros dados no struct. Os
membros serao recalculados se excederem seus valores maximos (ex. 40 de
outubro mudara para 9 de novembro). Uma chamada a mktime() tambem
colocara informacoes sobre o fuso horario em tzname. Se o tempo
especificado nao puder ser representado no calendario (em segundos
desde a Epoca), mktime() retornara (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'EM
date(1), gettimeofday(2), time(2), tzset(3), difftime(3), strftime(3),
newctime(3)
TRADUZIDO POR LDP-BR em 21/08/2000.
Paulo Cesar Mendes <drpc@ism.com.br> (traducao)
xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisao)