#include <time.h>
size_t strftime (char *s, size_t max, constchar *format, conststruct tm *tm);
|
Le premier argument de la fonction est la chaîne de caractère à remplire avec au plus max-1 caractères. Le paramètre format est une chaîne de caractère décrivant le format souhaité dont voici les spécificateurs de format :
%a Nom du jour en abrégé
%A Nom du jour complet
%b Nom du mois en abrégé
%B Nom du mois complet
%c MM/JJ/AA HH:MM:SS
%d Numéro du jour dans le mois (0 à 31)
%H l'heure sur 24 heures
%I l'heure sur 12 heures
%m numéro du mois dans l'année (0 à 12)
%M les minutes (0 à 59)
%p AM ou PM suivant la partie de la journée
%S les secondes (0 à 59)
%U Numéro de la semaines en commençant la semanine le Dimanche
%W Idem %U sauf que la semaines commençe le Lundi
%w Numéro du jour de la semaine (0 à 6)
%x MM/JJ/AA
%X HH:MM:SS
%y Année sur deux chiffres
%Y Année sur quatres chiffres
%Z Nom du fuseau horaire
%% Le caractère %
Voici un exemple pour illustrer cela :
"Nous sommes le %A %d %B %Y, il est %X\n"
|
La fonction strftime renvoie la taille de la chaîne générée (ou zéro si elle dépasse max-1 caractères), un premier appel permet d'allouer la mémoire nécessaire et un second pour stocker la chaîne.