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

CKTIS / C

strftime — formátování data a času

strftime z <time.h> formátuje struct tm do bufferu. Formát určuje podobu data a času; vyhraďte místo pro ukončovací nulový znak.

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

Syntaxe

#include <time.h>
size_t strftime(char * restrict s, size_t maxsize,
                const char * restrict format,
                const struct tm * restrict timeptr);

strftime zapisuje formátovanou hodnotu struct tm do s. format obsahuje text a specifikátory převodu: %Y označuje rok, %m měsíc, %d den a %% doslovný znak %. Nastavení LC_TIME ovlivňuje reprezentace závislé na místním nastavení.

maxsize je kapacita bufferu včetně \0. Návratová hodnota udává počet zapsaných bajtů bez \0. Pokud je buffer příliš malý, funkce vrátí nulu; jeho obsah nepovažujte za platný řetězec. Nulu vrací také úspěšný prázdný výsledek.

Použitá pole musí obsahovat platné hodnoty: tm_year počítá roky od roku 1900 a tm_mon počítá měsíce od nuly. Překrývající se oblasti kopírování a nepodporované specifikátory převodu způsobují nedefinované chování.

Příklady

#include <stdio.h>
#include <time.h>

int main(void)
{
    const struct tm date = {
        .tm_year = 2024 - 1900,
        .tm_mon = 2 - 1,
        .tm_mday = 29
    };
    char text[32];
    if (strftime(text, sizeof text, "%Y-%m-%d", &date) == 0) {
        return 1;
    }
    puts(text);
    return 0;
}

Výsledek

2024-02-29

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