WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen