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.