Provided by:
manpages-es_1.55-4_all 
NOMBRE
time - obtiene el tiempo de calendario, en segundos
SINOPSIS
#include <time.h>
time_t time(time_t *t);
DESCRIPCI N
time devuelve el tiempo transcurrido, medido en segundos, desde ‘la
Época’: las 0 horas 0 minutos 0 segundos, tiempo universal coordinado,
del 1 de enero de 1970. Esta medida se llama el ‘‘tiempo de calen‐
dario’’.
Si t no es el puntero nulo, el valor devuelto también se guarda en la
zona de memoria a la que apunte t.
En caso de éxito se devuelve el tiempo transcurrido, en segundos, desde
la Época. En caso de error, se devuelve ((time_t)-1) y se asigna a la
variable errno un valor apropiado.
ERRORES
EFAULT t apunta fuera de su espacio de direcciones accesible.
OBSERVACIONES
POSIX.1 define el valor segundos desde la Época como el número de
segundos transcurridos entre un instante específico y la Época, calcu‐
lados a partir del Tiempo Coordinado Universal (UTC) según una fórmula
que simplifica la conversión ignorando los segundos de salto y
suponiendo que todos los años divisibles por 4 son bisiestos. Este
valor no es el mismo que el número real de segundos transcurrido entre
dicho instante y la Época debido a los segundos de salto y debido a que
no se requiere que los relojes estén sincronizados con una referencia
estándar. La intención es que la interpretación de los valores segundos
desde la Época sea consistente; vea POSIX.1 Anexo B 2.2.2 para una
explicación más amplia.
SVr4, SVID, POSIX, X/OPEN, BSD 4.3 y C ANSI.
Bajo BSD 4.3, esta llamada se considera anticuada, pues se tiene get
timeofday(2), que proporciona un resultado más preciso. POSIX no
especifica ninguna condición de error.
ctime(3), date(1), ftime(3), gettimeofday(2)