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

NOMBRE

       time - obtiene el tiempo de calendario, en segundos

SINOPSIS

       #include <time.h>

       time_t time(time_t *t);

DESCRIPCI'ON

       time  devuelve  el  tiempo  transcurrido, medido en segundos, desde `la
       Epoca': 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 tambien se guarda  en  la
       zona de memoria a la que apunte t.

VALOR DEVUELTO

       En caso de exito se devuelve el tiempo transcurrido, en segundos, desde
       la Epoca. 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 'Epoca como el numero de
       segundos  transcurridos  entre  un  instante  especifico  y  la  Epoca,
       calculados  a  partir  del  Tiempo Coordinado Universal (UTC) segun una
       formula que simplifica la conversion ignorando los segundos de salto  y
       suponiendo  que  todos  los  anos divisibles por 4 son bisiestos.  Este
       valor no es el mismo que el numero real de segundos transcurrido  entre
       dicho instante y la Epoca debido a los segundos de salto y debido a que
       no se requiere que los relojes esten sincronizados con  una  referencia
       estandar. La intencion es que la interpretacion de los valores segundos
       desde la 'Epoca sea consistente; vea POSIX.1  Anexo  B  2.2.2  para  una
       explicacion mas 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 mas  preciso.   POSIX  no
       especifica ninguna condicion de error.

V'EASE TAMBI'EN

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