WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

asctime — Datum und Uhrzeit in festem Textformat

asctime wandelt eine struct tm in Text mit festem Format um. In C23 ist die Funktion veraltet und sollte in neuem Code vermieden werden.

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

Syntax

#include <time.h>
[[deprecated]] char *asctime(const struct tm *timeptr);

asctime aus <time.h> liest eine struct tm und gibt einen Zeiger auf Text zurück: 25 Zeichen plus \0, mit englischen Abkürzungen und einem abschließenden \n. Die Funktion rechnet weder Zeitzonen um noch berechnet sie den Wochentag. tm_mon zählt die Monate ab null; tm_year zählt die Jahre seit 1900.

NULL, Felder außerhalb ihrer normalen Wertebereiche oder ein Jahr außerhalb von 1000–9999 führen zu undefiniertem Verhalten. Der Puffer gehört der Bibliothek: Gib ihn nicht frei; nachfolgende Aufrufe von asctime oder ctime können ihn überschreiben. Die Funktion ist nicht reentrant und garantiert keine Freiheit von Datenrennen. In C23 ist sie mit [[deprecated]] gekennzeichnet; verwende in neuem Code vorzugsweise strftime mit einem eigenen Puffer.

Beispiele

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

int main(void)
{
    const struct tm value = {
        .tm_year = 123,
        .tm_mon = 0,
        .tm_mday = 1,
        .tm_wday = 0,
        .tm_yday = 0,
        .tm_hour = 12,
        .tm_min = 34,
        .tm_sec = 56,
        .tm_isdst = 0
    };

    return fputs(asctime(&value), stdout) == EOF ? 1 : 0;
}

Ergebnis

Sun Jan  1 12:34:56 2023

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