Provided by: manpages-es_1.55-8_all bug

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)