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