Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

strftime — formater les dates et les heures

strftime de <time.h> formate une struct tm dans un tampon. Le format définit la représentation de la date et de l’heure ; prévoyez de la place pour le caractère nul final.

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

Syntaxe

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

strftime écrit une valeur struct tm formatée dans s. format contient du texte et des spécificateurs de conversion : %Y désigne l’année, %m le mois, %d le jour et %% un caractère % littéral. Les paramètres LC_TIME influent sur les représentations dépendant de la langue et de la région.

maxsize est la capacité du tampon, y compris \0. La valeur renvoyée compte les octets écrits, sans \0. Si le tampon est trop petit, la fonction renvoie zéro ; ne traitez pas son contenu comme une chaîne valide. Un résultat vide obtenu avec succès renvoie également zéro.

Les champs utilisés doivent contenir des valeurs valides : tm_year compte les années depuis 1900 et tm_mon les mois à partir de zéro. Des zones de copie qui se chevauchent et des spécificateurs de conversion non pris en charge entraînent un comportement indéfini.

Exemples

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

Résultat

2024-02-29

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources