CKTIS / C
strftime — Datums- und Zeitangaben formatieren
strftime aus <time.h> formatiert eine struct tm in einen Puffer. Das Format legt die Darstellung von Datum und Uhrzeit fest; reservieren Sie Platz für das abschließende Nullzeichen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <time.h>
size_t strftime(char * restrict s, size_t maxsize,
const char * restrict format,
const struct tm * restrict timeptr);strftime schreibt einen formatierten Wert vom Typ struct tm in s. format enthält Text und Umwandlungsspezifizierer: %Y steht für das Jahr, %m für den Monat, %d für den Tag und %% für ein wörtliches %. Einstellungen von LC_TIME beeinflussen lokalisierungsabhängige Darstellungen.
maxsize ist die Pufferkapazität einschließlich \0. Der Rückgabewert zählt die geschriebenen Bytes ohne \0. Ist der Puffer zu klein, gibt die Funktion null zurück; behandeln Sie seinen Inhalt dann nicht als gültige Zeichenkette. Auch ein erfolgreiches leeres Ergebnis liefert null.
Die verwendeten Felder müssen gültige Werte enthalten: tm_year zählt die Jahre seit 1900, tm_mon die Monate ab null. Überlappende Kopierbereiche und nicht unterstützte Umwandlungsspezifizierer führen zu undefiniertem Verhalten.
Beispiele
#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;
}Ergebnis
2024-02-29
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.