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.