NOME

       time - obtém o tempo em segundos

SINOPSE

       #include <time.h>

       time_t time(time_t *t);

DESCRIÇÃO

       time  retorna  o  tempo  desde  a  Era  (1  de Janeiro de 1970 às 00:00:00 UTC), medido em
       segundos.

       Se t não é nulo, o valor devolvido é armazenado, também, na memória apontado por t.

VALORES RETORNADOS

       Em caso  de  successo,  o  valor  do  tempo  em  segundo  é  retornado.   Caso  contrário,
       ((time_t)-1) é retornado, e errno é selecionado adequadamente.

ERROS

       EFAULT t aponta para fora de seu espaço de endereço acessível.

NOTAS

       POSIX.1  define segundo desde a Época como um valor para ser interpretado como o número de
       segundos entre um tempo especificado e a Época, de acordo com uma fórmula para conversão a
       partir de UTC equivalente para conversão na base nativa que pula os segundos são ignorados
       e todos os anos divisíveis por 4 são anos pulados. Este valor não é igual ao número  atual
       de  segundos  entre  o  tempo  e  a  Época,  por causa dos segundo pulados e por causa dos
       relógios que não são requeridos para ser  sincronizados  para  uma  referência  padrão.  A
       intenção é que a interpretação de segundos entre o valor Época é consistente; veja POSIX.1
       Anexo B 2.2.2 para mais argumentos.

DE ACORDO COM

       SVr4, SVID, POSIX, X/OPEN, BSD 4.3
       No BSD 4.3, esta chamada é obsoleta e usa-se gettimeofday(2).  POSIX does  não  especifica
       qualquer condição de erro.

VEJA TAMBÉM

       ctime(3), date(1), ftime(3), gettimeofday(2)

TRADUZIDO POR LDP-BR em 21/08/2000.

       André  L.  Fassone  Canova  <lonelywolf@blv.com.br>  (tradução)  xxxxxxxxxxxxxxxxxxxxxxxxx
       <xxx@xxxxxx.xxx.xx> (revisão)