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

CKTIS / C

time.h — data e hora

O cabeçalho <time.h> disponibiliza tipos e funções para data e hora. Distingue o tempo do processador do tempo de calendário.

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

Sintaxe

#include <time.h>

<time.h> declara, entre outros, time_t, clock_t, struct tm e struct timespec. struct tm armazena os componentes da data; strftime dá-lhes formato.

CLOCKS_PER_SEC escala os resultados de clock() para segundos de tempo do processador, não para tempo real decorrido. Divide por (double)CLOCKS_PER_SEC e verifica o valor de erro (clock_t)-1.

TIME_UTC seleciona a base UTC em timespec_get(&ts, TIME_UTC): em caso de sucesso, devolve TIME_UTC; em caso de erro, devolve 0. A época é definida pela implementação e não é necessariamente a época Unix. Um campo em nanossegundos não garante uma resolução de nanossegundos; UTC não garante monotonicidade.

Exemplos

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

int main(void)
{
    struct tm date = {
        .tm_year = 2024 - 1900,
        .tm_mon = 3 - 1,
        .tm_mday = 14
    };
    char text[32];

    if (strftime(text, sizeof text, "%Y-%m-%d", &date) == 0) {
        return 1;
    }
    puts(text);
    return 0;
}

Resultado

2024-03-14

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