Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

mktime — convertir y normalizar la hora local

mktime convierte a time_t la hora local almacenada en una struct tm y normaliza sus campos si la operación tiene éxito.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

mktime, de <time.h>, acepta un puntero a una struct tm modificable. Interpreta la hora como local, no como UTC; time_t no tiene por qué codificar segundos Unix.

tm_year cuenta los años desde 1900 y tm_mon los meses desde 0. Los campos pueden superar sus rangos habituales. Si tiene éxito, la función normaliza la estructura y calcula tm_wday y tm_yday, cuyos valores de entrada se ignoran inicialmente.

tm_isdst: un valor positivo indica horario de verano, cero indica que no lo hay y un valor negativo solicita su detección. Para las horas omitidas o repetidas durante los cambios de hora, la elección no está especificada.

El resultado es un time_t; una hora no representable produce (time_t)-1. La normalización no es una validación estricta de la fecha.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes