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)