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

CKTIS / C

mktime — converter e normalizar a hora local

mktime converte para time_t a hora local guardada numa struct tm e, em caso de sucesso, normaliza os respetivos campos.

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

Sintaxe

#include <time.h>
time_t mktime(struct tm *timeptr);

mktime, de <time.h>, aceita um ponteiro para uma struct tm modificável. Interpreta a hora como local, não como UTC; time_t não tem necessariamente de codificar segundos Unix.

tm_year conta os anos desde 1900 e tm_mon os meses desde 0. Os campos podem ultrapassar os intervalos habituais. Em caso de sucesso, a função normaliza a estrutura e calcula tm_wday e tm_yday, cujos valores de entrada são inicialmente ignorados.

tm_isdst: um valor positivo indica a hora de verão, zero indica a sua ausência e um valor negativo pede a sua deteção. Para horas omitidas ou repetidas durante as mudanças da hora, a escolha não é especificada.

O resultado é um time_t; uma hora não representável produz (time_t)-1. A normalização não constitui uma validação rigorosa da data.

Exemplos

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

int main(void)
{
    struct tm t = {0};
    t.tm_year = 2024 - 1900;
    t.tm_mon = 0;
    t.tm_mday = 32;
    t.tm_hour = 12;
    t.tm_isdst = -1;

    if (mktime(&t) == (time_t)-1) {
        puts("conversion failed");
        return 1;
    }

    printf("%04d-%02d-%02d\n",
           t.tm_year + 1900, t.tm_mon + 1, t.tm_mday);
    return 0;
}

Resultado

2024-02-01

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