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.