Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strftime — formattare date e orari

strftime di <time.h> formatta una struct tm in un buffer. Il formato determina la rappresentazione di data e ora; lasciare spazio per il carattere nullo finale.

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

Sintassi

#include <time.h>
size_t strftime(char * restrict s, size_t maxsize,
                const char * restrict format,
                const struct tm * restrict timeptr);

strftime scrive in s un valore struct tm formattato. format contiene testo e specificatori di conversione: %Y indica l’anno, %m il mese, %d il giorno e %% un carattere % letterale. Le impostazioni di LC_TIME influiscono sulle rappresentazioni dipendenti dalle impostazioni locali.

maxsize è la capacità del buffer, compreso \0. Il valore restituito conta i byte scritti, escluso \0. Se il buffer è troppo piccolo, la funzione restituisce zero; non considerare valido il suo contenuto come stringa. Anche un risultato vuoto ottenuto correttamente restituisce zero.

I campi utilizzati devono contenere valori validi: tm_year conta gli anni a partire dal 1900 e tm_mon conta i mesi a partire da zero. Le regioni di copia sovrapposte e gli specificatori di conversione non supportati causano un comportamento indefinito.

Esempi

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

Risultato

2024-02-29

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti