KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strftime — datums en tijden opmaken

strftime uit <time.h> maakt een opgemaakte struct tm in een buffer. Het formaat bepaalt de weergave van datum en tijd; reserveer ruimte voor het afsluitende nulteken.

Versie: 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 schrijft een opgemaakte struct tm-waarde naar s. format bevat tekst en conversiespecificaties: %Y betekent jaar, %m maand, %d dag en %% een letterlijk %-teken. Instellingen van LC_TIME beïnvloeden regiogebonden weergaven.

maxsize is de buffercapaciteit, inclusief \0. De geretourneerde waarde telt de geschreven bytes, exclusief \0. Is de buffer te klein, dan retourneert de functie nul; behandel de inhoud niet als een geldige tekenreeks. Ook een geslaagd leeg resultaat levert nul op.

De gebruikte velden moeten geldige waarden bevatten: tm_year telt jaren vanaf 1900 en tm_mon telt maanden vanaf nul. Overlappende kopieergebieden en niet-ondersteunde conversiespecificaties veroorzaken ongedefinieerd gedrag.

Voorbeelden

#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;
}

Resultaat

2024-02-29

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.

Bronnen