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 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.
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.
VÉASE TAMBIÉN¶
ctime(3),
date(1),
ftime(3),
gettimeofday(2)