CKTIS / C
time — získání aktuálního kalendářního času
Funkce time z <time.h> vrací přibližnou hodnotu aktuálního kalendářního času jako time_t; ověřte, zda výsledek není (time_t)(-1).
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <time.h>
time_t time(time_t *timer);time vrací nejlepší přibližnou hodnotu aktuálního kalendářního času, kterou implementace poskytuje. Pokud čas není dostupný, vrátí (time_t)(-1). Než hodnotu použijete, zkontrolujte tento výsledek.
Volání time(NULL) pouze vrátí výsledek. Při použití nenulového ukazatele, jako v time(&stored), funkce navíc uloží vrácenou hodnotu do ukazovaného objektu typu time_t.
Kódování času není určeno: přenositelný kód nesmí předpokládat, že jde o sekundy od unixové epochy. Příklad porovnává uloženou a vrácenou hodnotu, místo aby vypisoval datum, které se mění.
Příklady
#include <stdio.h>
#include <time.h>
int main(void)
{
time_t stored;
time_t result = time(&stored);
if (result == (time_t)(-1)) {
puts("Time unavailable");
return 1;
}
puts(stored == result ? "Values match" : "Values differ");
return 0;
}Výsledek
Values match
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.