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.

VÉASE TAMBIÉN

       ctime(3), date(1), ftime(3), gettimeofday(2)