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.