Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

time — obtener la hora de calendario actual

La función time de <time.h> devuelve una aproximación de la hora de calendario actual como time_t; comprueba si el resultado es (time_t)(-1).

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <time.h>
time_t time(time_t *timer);

time devuelve la mejor aproximación disponible en la implementación de la hora de calendario actual. Si la hora no está disponible, devuelve (time_t)(-1). Comprueba este resultado antes de usar el valor.

La llamada time(NULL) solo devuelve el resultado. Si se proporciona un puntero no nulo, como en time(&stored), la función también almacena el valor devuelto en el objeto time_t señalado.

La codificación de la hora no está especificada: el código portable no puede suponer que son segundos desde la época Unix. El ejemplo compara el valor almacenado con el devuelto, en lugar de mostrar una fecha que va cambiando.

Ejemplos

#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t stored;
    time_t result = time(&stored);

    if (result == (time_t)(-1)) {
        puts("Time unavailable");
        return 1;
    }

    puts(stored == result ? "Values match" : "Values differ");
    return 0;
}

Resultado

Values match

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes