Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

time — obter a hora de calendário atual

A função time de <time.h> devolve uma aproximação da hora de calendário atual como time_t; verifique se o resultado é (time_t)(-1).

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

time devolve a melhor aproximação da hora de calendário atual que a implementação consegue fornecer. Quando a hora não está disponível, devolve (time_t)(-1). Verifique este resultado antes de utilizar o valor.

A chamada time(NULL) limita-se a devolver o resultado. Com um ponteiro não nulo, como em time(&stored), a função também guarda o valor devolvido no objeto time_t apontado.

A codificação da hora não está especificada: o código portátil não pode assumir que se trata de segundos desde a época Unix. O exemplo compara o valor guardado com o valor devolvido, em vez de apresentar uma data que está sempre a mudar.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes