CKTIS / C
asctime — datum- en tijdtekst met een vast formaat
asctime zet een struct tm om in tekst met een vast formaat. In C23 is de functie verouderd en moet deze in nieuwe code worden vermeden.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <time.h>
[[deprecated]] char *asctime(const struct tm *timeptr);asctime uit <time.h> leest een struct tm en retourneert een pointer naar tekst: 25 tekens plus \0, met Engelse afkortingen en een afsluitende \n. De functie converteert geen tijdzones en berekent de weekdag niet. tm_mon telt maanden vanaf nul; tm_year telt jaren vanaf 1900.
NULL, velden buiten hun normale bereiken of een jaar buiten 1000–9999 leiden tot ongedefinieerd gedrag. De buffer is eigendom van de bibliotheek: maak hem niet vrij; volgende aanroepen van asctime of ctime kunnen hem overschrijven. De functie is niet reentrant en garandeert niet dat er geen data races zijn. In C23 is de functie gemarkeerd met [[deprecated]]; gebruik voor nieuwe code liever strftime met een eigen buffer.
Voorbeelden
#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;
}
Resultaat
Sun Jan 1 12:34:56 2023
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.