strftime

size_t strftime( char* str, size_t count,
                 const char* format, const struct tm* tp );

size_t strftime( char* restrict str, size_t count,
                 const char* restrict format, const struct tm* restrict tp );

Convertit les informations de date et d'heure à partir d'un temps calendaire donné tp en une chaîne de caractères multi-octets terminée par un caractère nul str selon la chaîne de format format. Jusqu'à count octets sont écrits.

Paramètres

Chaîne de format

La chaîne de format se compose de zéro ou plusieurs spécificateurs de conversion et de caractères ordinaires (sauf %). Tous les caractères ordinaires, y compris le caractère nul de terminaison, sont copiés dans la chaîne de sortie sans modification. Chaque spécification de conversion commence par le caractère %, facultativement suivi d'un modificateur E ou O (ignoré s'il n'est pas supporté par la locale), suivi du caractère qui détermine le comportement du spécificateur. Les spécificateurs de format suivants sont disponibles :

Valeur de retour

Le nombre d'octets écrits dans le tableau de caractères pointé par str sans inclure le '\0' de terminaison en cas de succès. Si count a été atteint avant que la chaîne entière puisse être stockée, 0 est renvoyé et le contenu est indéterminé.

Exemple

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

int main(void)
{
    char buff[70];
    struct tm my_time =
    {
        .tm_year = 112, // = year 2012
        .tm_mon = 9,    // = 10th month
        .tm_mday = 9,   // = 9th day
        .tm_hour = 8,   // = 8 hours
        .tm_min = 10,   // = 10 minutes
        .tm_sec = 20    // = 20 secs
    };

    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");

    setlocale(LC_TIME, "el_GR.utf8");

    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
}

Sunday Sun Oct  9 08:10:20 2012
Κυριακή Κυρ 09 Οκτ 2012 08:10:20 πμ EST

Références

Voir aussi