Man Strftime en français
STRFTIME(3)               Manuel du programmeur Linux              STRFTIME(3)



 

NOM


       strftime - Formater la date et l'heure.

 

SYNOPSIS


       #include 

       size_t strftime (char *s, size_t max, const char *format,
                           const struct tm *tm);

 

DESCRIPTION






       La  fonction strftime() formate les divers champs de la structure tm en
       fonction de la chaine de specification format, puis place  le  resultat
       dans la chaine s de taille max.

       Les caracteres ordinaires presents dans la chaine format seront simple-
       ment copies dans s. Les specifications de conversion  sont  introduites
       par  le  caractere   %   et terminees par un caractere specificateur de
       conversion,et sont remplaces, dans la chaine s ainsi :

       %a     Le nom abrege du jour de la semaine, en fonction de la localisa-
              tion en cours.

       %A     Le  nom complet du jour de la semaine, en fonction de la locali-
              sation en cours.

       %b     Le nom abrege du mois, en fonction de la localisation en  cours.

       %B     Le nom complet du mois, en fonction de la localisation en cours.

       %c     La representation classique de la date et de l'heure, suivant la
              localisation en cours.

       %C     Le  siecle  (annee/100)  sous  forme de nombre de deux chiffres.
              (SU)

       %d     Le quantieme du mois sous forme de nombre decimal (entre  01  et
              31).

       %D     Equivalent  a  %m/%d/%y.  Seulement  pour  les  americains.  Ces
              derniers doivent noter que les autres pays preferent  le  format
              %d/%m/%y. Dans un contexte international ce format est ambigu et
              doit etre evite. (SU)

       %e     Comme  %d,  le  quantieme  du  mois  sous  forme  decimal,  mais
              l'eventuel zero en tete est remplace par un espace. (SU)

       %E     Modificateur :  Utiliser  un  format de rechange. Voir plus bas.
              (SU)

       %F     Equivalent de %Y-%m-%d (Format de date ISO 8601). (C99)

       %G     L'annee ISO 8601 avec le siecle comme  nombre  decimal.  L'annee
              sur quatre chiffres correspond au numero de la semaine ISO (voir
              %V).  C'est le meme format que %y, sauf  que  si  le  numero  de
              semaine  appartient  a  l'annee  suivante  ou  precedente, c'est
              celle-ci qui est affichee a la place. (TZ)

       %g     Comme %G sans le siecle, c'est-a-dire avec une  annee  sur  deux
              chiffres (00-99). (TZ)

       %h     Equivalent a %b. (SU)

       %H     L'heure,  sur  24 heures, sous forme de nombre decimal (entre 00
              et 23).

       %I     L'heure, sur 12 heures, sous forme de nombre decimal  (entre  01
              et 12).

       %j     Le numero du jour dans l'annee (entre 001 et 366).

       %k     L'heure (sur 24 heures) sous forme de nombre decimal (intervalle
              0 a 23).  Les chiffres uniques sont precedes  d'un  blanc  (voir
              aussi %H). (TZ).

       %l     L'heure   (sur  12  heures) sous forme de nombre decimal (inter-
              valle 1 a 12).  Les chiffres uniques sont  precedes  d'un  blanc
              (voir aussi %I). (TZ).

       %m     Le numero du mois (entre 01 et 12).

       %M     La minute, sous forme de nombre decimal (00 a 59).

       %n     Un caractere saut-de-ligne. (SU)

       %O     Modificateur :  Utiliser  un  format de rechange. Voir plus bas.
              (SU)

       %p     L'une des deux chaines  AM  ou  PM  en fonction de  l'heure,  ou
              la  traduction de ces chaines en fonctions de la localisation en
              cours.  Midi est traite comme  PM  et Minuit comme  AM .

       %P     Comme %p mais en minuscule:  am  ou  pm  ou  une  chaine  locale
              equivalente. (GNU)

       %r     L'heure  en  notation  a.m. ou p.m.  Dans la localisation POSIX,
              c'est equivalent a  %I:%M:%S %p . (SU)

       %R     L'heure en format 24 heures (%H:%M). (SU).  Pour avoir les  sec-
              ondes voir %T.

       %s     Le  nombre  de  secondes  ecoulees  depuis le 1er Janvier 1970 a
              00:00:00 UTC. (TZ).

       %S     La seconde, sous forme de nombre decimal (00-60).   L'intervalle
              peut  etre superieur a 60 pour autoriser des secondes de rattra-
              page).

       %t     Un caractere Tab. (SU)

       %T     L'heure en notation 24 heures (%H:%M:%S). (SU)

       %u     Le jour de la semaine sous forme decimal,  de  1  (Lundi)  a  7.
              Voir aussi %w. (SU)

       %U     Le numero de la semaine dans l'annee, sous forme de nombre deci-
              mal (00-53), en commencant le comptage au  premier  Dimanche  de
              l'annee. Voir aussi %V et %W.

       %V     Le  numero  de  semaine  ISO  8601:1988 de l'annee en cours sous
              forme de nombre decimal dans l'intervalle 01-53, ou la semaine 1
              est la premiere ayant au moins 4 jours dans l'annee en cours, et
              ou Lundi est le premier jour de la semaine. Voir aussi %U et %W.
              (SU)

       %W     Le numero de la semaine dans l'annee, sous forme de nombre deci-
              mal (00-53), en commencant  le  comptage  au  premier  Lundi  de
              l'annee.

       %w     Le  numero  du  jour  de  la semaine, sous forme decimale (0-6),
              Dimanche valant 0. Voir aussi %u.

       %x     La representation usuelle de la  date,  sans  l'heure,  dans  la
              localisation en cours.

       %X     La  representation  usuelle  de  l'heure,  sans la date, dans la
              localisation en cours.

       %y     L'annee, sous forme de nombre decimal, sans le siecle (entre  00
              et 99).

       %Y     L'annee, sous forme de nombre decimal, incluant le siecle.

       %z     Le  fuseau  horaire  sous forme de decalage GMT. Necessaire pour
              creeer des dates conformes a la RFC 822  (avec  "%a,  %d  %b  %Y
              %H:%M:%S %z"). (GNU)

       %Z     Le nom ou l'abreviation du fuseau horaire.

       %+     La date et l'heure au format date(1).  (TZ) (Non supporte par la
              glibc2.)

       %%     Un caractere % .

       Certaines specifications de conversion peuvent etre modifies en faisant
       preceder le caractere specificateur de conversion par le modificateur E
       ou O pour indiquer un format de rechange.  Si  le  format  de  rechange
       n'existe pas pour la localisation en cours, le comportement ne sera pas
       modifie.  Les specifications Single Unix  mentionnent  %Ec,  %EC,  %Ex,
       %EX,  %Ey,  %EY, %Od, %Oe, %OH, %OI, %Om, %OM, %OS, %Ou, %OU, %OV, %Ow,
       %OW, %Oy, ou l'action du modificateur O est d'utiliser un autre  format
       numerique  (par  exemple  des  chiffres  romains), et l'action de E est
       d'utiliser une representaiton dependant de la localisation.

       Les champs de la structure tm sont definis dans .   Voir  aussi
       ctime(3).

 

VALEUR RENVOYEE


       La  fonction  strftime() renvoie le nombre de caracteres ecrits dans la
       table s, sans compter l'octet  nul  final.  Si  la  chaine  etait  trop
       courte,  strftime() renvoie 0, et le contenu de la chaine est indefini.
       (Ceci, du moins, depuis la libc 4.4.4, des versions plus  anciennes  de
       la  libc,  comme  la  4.4.1,  renvoyaient  max  si la chaine etait trop
       courte)

       Remarquez qu'une valeur de retour  nulle  n'indique  pas  toujours  une
       erreur.   Dans de nombreuses localisations, par exemple, %p renvoie une
       chaine vide.

 

ENVIRONNEMENT


       Les variables d'environnement TZ et LC_TIME sont utilisees.

 

CONFORMITE


       SVr4, C89, C99.  Il y a une inclusion stricte entre les jeux de conver-
       sions  fournies par ANSI (sans marque), celles indiquees par les Speci-
       fications Single Unix (marquees SU), celles fournies par  le  paquetage
       TimeZone  d'Olson  (marquees TZ), et celles de la glibc (marquees GNU),
       sauf pour %+ qui n'est pas supporte par glibc2. D'un autre cote  glibc2
       offre plusieurs extensions.  POSIX.1 ne traite que les conversions ANSI
       C. POSIX.2 decrit a propos de date(1) plusieurs extensions  applicables
       egalement a strftime().  La conversion %F est dans C99 et POSIX.1-2001.

       Dans SUSv2, le %S specifie permettait un intervalle de 00  a  61,  pour
       autoriser  la  possibilite  theorique  d'une minute incluant une double
       seconde de rattrapage (il n'y a jamais eu de telle minute).

 

NOTES GLIBC


       La glibc fournit des extensions pour les specifications de  conversion.
       (Ces  extensions  ne sont pas specifiees par POSIX.1-2001 mais quelques
       autres systemes fournissent des fonctionnalites similaires.)  Entre  le
       caractere   %   et  le  caractere  specificateur de conversion, on peut
       specifie un attribut optionnel et un champ width.   (Ceux-ci  precedent
       les modificateurs E ou 0 s'ils sont presents.)

       Les caracteres attributs suivants sont autorises :

       _      (souligne)  Completer  une chaine de resultat numerique avec des
              espaces.

       -      (tiret) Ne pas completer une chaine de resultat numerique.

       0      Completer une chaine de resultat numerique avec des  zeros  meme
              si  le caractere specificateur de conversion utilise des espaces
              par defaut.

       ^      Convertir une chaine alphabetique en une  chaine  resultante  en
              majuscule.

       #      Echanger  la  casse de la chaine resultat (Cet attribut ne fonc-
              tionne qu'avec certains caracteres specificateurs de conversion,
              et parmi ceux-ci, il n'est vraiment utile qu'avec %Z).

       Un   specificateur   de   largeur   decimal   optionnel   peut   suivre
       l'(eventuellement absent) attribut.  Si la taille  naturelle  du  champ
       est  plus  petite que cette largeur, la chaine resultat sera alors com-
       pletee (sur la gauche) jusqu'a la largeur specifiee.

 

BOGUES


       Certaines versions boguees de gcc se plaignent de l'utilisation de %c :
       warning:  `%c'  yields  only  last  2  digits  of year in some locales.
       (Attention : ne donne que les deux derniers chiffres  de  l'annee  dans
       certaines  localisations).  Bien sr, les programmeurs sont encourages a
       utiliser %c, cela donne la representation preferee de date et  d'heure.
       Il  y  a  eu des tas d'astuces bizarres pour eviter ce probleme de gcc.
       Une relativement propre est d'utiliser une fonction intermediaire :
              size_t my_strftime(char *s, size_t max, const char  *fmt,  const
              struct tm *tm) {
                      return strftime(s, max, fmt, tm);
              }

 

EXEMPLE


       Le programme suivant peut etre utilise pour experimenter strftime().

       #include 
       #include 
       #include 

       int
       main(int argc, char *argv[])
       {
           char outstr[200];
           time_t t;
           struct tm *tmp;

           t = time(NULL);
           tmp = localtime(&t);
           if (tmp == NULL) {
               perror("localtime");
               exit(EXIT_FAILURE);
           }

           if (strftime(outstr, sizeof(outstr), argv[1], tmp) == 0) {
               fprintf(stderr, "strftime returned 0");
               exit(EXIT_FAILURE);
           }

           printf("La chaine resultat est \"%s\"\n", outstr);
           exit(EXIT_SUCCESS);
       } /* main */

       Voici  quelques exemples de la chaine resultat produite par l'implemen-
       tation glibc de strftime()

       $ ./a.out "%m"
       La chaine resultat est "11"
       $ ./a.out "%5m"
       La chaine resultat est "00011"
       $ ./a.out "%_5m"
       La chaine resultat est "   11"

 

VOIR AUSSI


       date(1), time(2), ctime(3), setlocale(3), sprintf(3), strptime(3)

 

TRADUCTION


       Ce  document  est  une  traduction  realisee  par   Christophe   Blaess
         le  9 novembre 1996  et  revisee le
       14 aot 2006.

       L'equipe de traduction a fait le maximum pour realiser  une  adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est toujours consultable  via  la  commande :   LANG=C man 3 strftime .
       N'hesitez  pas  a  signaler  a l'auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.



LDP                            23 novembre 2005                    STRFTIME(3)