Namespaces
Variants

time

From cppreference.net
Definido en el encabezado <time.h>
time_t time ( time_t * arg ) ;

Devuelve el tiempo calendario actual codificado como un objeto time_t , y también lo almacena en el objeto time_t apuntado por arg (a menos que arg sea un puntero nulo)

Contenidos

Parámetros

arg - puntero a un time_t objeto donde se almacenará el tiempo, o un puntero nulo

Valor de retorno

Tiempo de calendario actual codificado como objeto time_t en caso de éxito, ( time_t ) ( - 1 ) en caso de error. Si arg no es un puntero nulo, el valor de retorno también se almacena en el objeto apuntado por arg .

Notas

La codificación del tiempo de calendario en time_t no está especificada, pero la mayoría de sistemas se ajustan a la especificación POSIX y devuelven un valor de tipo entero que contiene el número de segundos desde la Época . Las implementaciones en las que time_t es un entero con signo de 32 bits (muchas implementaciones históricas) fallan en el año 2038 .

Ejemplo

#include <stdint.h>
#include <stdio.h>
#include <time.h>
int main(void)
{
    time_t result = time(NULL);
    if (result != (time_t)(-1))
        printf("The current time is %s(%jd seconds since the Epoch)\n",
               asctime(gmtime(&result)), (intmax_t)result);
}

Salida posible:

The current time is Fri Apr 24 15:05:25 2015
(1429887925 seconds since the Epoch)

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.27.2.4 La función time (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.27.2.4 La función time (p: 286)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.27.2.4 La función time (p: 391)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.23.2.4 La función time (p: 341)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 4.12.2.4 La función time

Véase también

convierte el tiempo desde la época a tiempo calendario expresado como hora local
(función)
convierte el tiempo desde la época a tiempo calendario expresado como Tiempo Universal Coordinado (UTC)
(función)
devuelve el tiempo calendario en segundos y nanosegundos basado en una base de tiempo dada
(función)