time(2) 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 calendario''.

Si t no es el puntero nulo, el valor devuelto también se guarda en la zona de memoria a la que apunte t.

VALOR DEVUELTO

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, calculados 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.

CONFORME A

SVr4, SVID, POSIX, X/OPEN, BSD 4.3 y C ANSI.
Bajo BSD 4.3, esta llamada se considera anticuada, pues se tiene gettimeofday(2), que proporciona un resultado más preciso. POSIX no especifica ninguna condición de error.