Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje