bionic (2) time.2.gz

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)