Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

mktime — prevod a normalizácia miestneho času

mktime prevádza miestny čas uložený v struct tm na time_t a pri úspechu normalizuje jej polia.

Verzia: C23; repository compiler flag, production runtime not attested

Syntax

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

mktime z <time.h> prijíma ukazovateľ na upraviteľnú struct tm. Čas interpretuje ako miestny, nie ako UTC; time_t nemusí kódovať sekundy Unixového času.

tm_year počíta roky od roku 1900 a tm_mon mesiace od 0. Hodnoty polí môžu presahovať bežné rozsahy. Pri úspechu funkcia štruktúru normalizuje a vypočíta tm_wday a tm_yday, ktorých vstupné hodnoty sa najprv ignorujú.

tm_isdst: kladná hodnota znamená letný čas, nula jeho neprítomnosť a záporná hodnota žiada o rozpoznanie. Pri preskočených alebo opakovaných časoch počas zmeny času nie je výber špecifikovaný.

Výsledkom je time_t; čas, ktorý sa nedá reprezentovať, vráti (time_t)-1. Normalizácia nie je prísnou kontrolou platnosti dátumu.

Príklady

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

Výsledok

2024-02-01

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje