Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strftime — formatowanie daty i czasu

strftime z <time.h> formatuje struct tm do bufora. Wzorzec określa zapis daty i czasu; trzeba zapewnić miejsce na końcowy znak zerowy.

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

Składnia

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

strftime zapisuje sformatowaną wartość struct tm do s. format zawiera tekst i specyfikatory: %Y oznacza rok, %m miesiąc, %d dzień, a %% znak %. Ustawienia LC_TIME wpływają na reprezentacje zależne od lokalizacji.

maxsize to pojemność bufora, łącznie z \0. Wynik to liczba zapisanych bajtów bez \0. Przy zbyt małym buforze funkcja zwraca zero, a jego zawartości nie wolno traktować jako poprawnego napisu. Poprawny pusty wynik także daje zero.

Używane pola muszą mieć prawidłowe wartości: tm_year liczy lata od 1900, a tm_mon miesiące od zera. Nakładające się obszary kopiowania oraz nieobsługiwane specyfikatory powodują niezdefiniowane zachowanie.

Przykłady

#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;
}

Wynik

2024-02-29

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła