CKTIS / C
localtime — časová funkce C23
`localtime(timer)` z `<time.h>` převede určený `time_t` na rozložený místní občanský čas a vrátí ukazatel na `struct tm`; použije pravidla časového pásma a letního času prostředí. Při selhání může vrátit null.
Verze: C23
Syntaxe
struct tm *localtime(const time_t *timer);localtime(timer) z <time.h> převede určený time_t na rozložený místní občanský čas a vrátí ukazatel na struct tm; použije pravidla časového pásma a letního času prostředí. Při selhání může vrátit null.
Příklad předá nulový time_t do localtime a ověří ukazatel i rozsahy měsíce, dne, hodiny, minuty a sekundy. V běhovém prostředí vypíše 1 bez předpokladu konkrétního pásma.
Výsledek míří na statický objekt, který další localtime, gmtime nebo ctime může přepsat; struct tm ihned zkopírujte. Souběžná volání nemusí být bezpečná. tm_isdst může být kladné, nulové či záporné; nejednoznačné nebo neexistující místní časy při DST vyžadují opatrnost při návratu přes mktime.
Příklady
#include <stdio.h>
#include <time.h>
int main(void){time_t raw=0;struct tm *v=localtime(&raw);int ok=v&&v->tm_mon>=0&&v->tm_mon<=11&&v->tm_mday>=1&&v->tm_mday<=31&&v->tm_hour>=0&&v->tm_hour<=23&&v->tm_min>=0&&v->tm_min<=59&&v->tm_sec>=0&&v->tm_sec<=60;printf("%d\n",ok);return 0;}
Výsledek
1
Příklad předá nulový `time_t` do `localtime` a ověří ukazatel i rozsahy měsíce, dne, hodiny, minuty a sekundy. V běhovém prostředí vypíše `1` bez předpokladu konkrétního pásma.