Provided by: manpages-pt-dev_20040726-4_all bug

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)