Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

mktime — pretvorba in normalizacija lokalnega časa

mktime pretvori lokalni čas, shranjen v struct tm, v time_t in ob uspehu normalizira njena polja.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

mktime iz <time.h> sprejme kazalec na spremenljivo struct tm. Čas razume kot lokalni, ne kot UTC; time_t ni nujno kodiran kot število sekund Unixovega časa.

tm_year šteje leta od leta 1900, tm_mon pa mesece od 0. Polja lahko presegajo običajne obsege. Ob uspehu funkcija normalizira strukturo ter izračuna tm_wday in tm_yday, katerih začetne vhodne vrednosti se prezrejo.

tm_isdst: pozitivna vrednost pomeni poletni čas, nič pomeni, da ga ni, negativna vrednost pa zahteva zaznavanje. Pri preskočenih ali ponovljenih urah ob prehodu ni določeno, katera možnost bo izbrana.

Rezultat je time_t; časa, ki ga ni mogoče predstaviti, vrne (time_t)-1. Normalizacija ni strogo preverjanje veljavnosti datuma.

Primeri

#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;
}

Rezultat

2024-02-01

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri