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)