STRPTIME(3)        Manuel du programmeur Linux        STRPTIME(3)


NOM
       strptime  -  Conversion d'une chaîne représentant une date
       en une structure tm.

SYNOPSIS
       #include <time.h>

       char *strptime  (char  *buf,  const  char  *format,  const
       struct tm *tm);


DESCRIPTION
       La  fonction  strptime() est complémentaire de la fonction
       strftime().   Elle  convertit  la  chaîne  de   caractères
       pointée par buf en une valeur de date/heure, qui est alors
       stockée dans la structure tm pointée par l'argument tm, la
       conversion  étant réalisée en suivant les indications con­
       tenues dans la chaîne format.  Cette dernière contient des
       descripteurs  de  champs  et du texte, rappelant scanf(3).
       Chaque descripteur consiste en un caractère %  suivi  d'un
       second  caractère  indiquant le champ à interpréter.  Tous
       les autres sont considérés comme du texte.   Les  descrip­
       teurs suivants sont applicables :

              %%     Le caractère %

              %a
              %A     Le  jour de la semaine en utilisant les noms
                     correspondants à la localisation.  Les  noms
                     abrégés ou entiers peuvent être utilisés.

              %b
              %B
              %h     le mois en utilisant les noms correspondants
                     à la  localisation.   Les  noms  abrégés  ou
                     entiers peuvent être utilisés.

              %c     la date et l'heure, comme %x %X

              %C     la date et l'heure en utilisant le format de
                     la localisation.

              %d
              %e     le jour du mois (1-31; les  zéros  au  début
                     sont autorisés mais pas indispensables)

              %D     la date, ainsi : %m/%d/%y

              %H
              %k     l'heure (0-23)

              %I
              %l     l'heure (0-12)




Linux                    10 Novembre 1996                       1





STRPTIME(3)        Manuel du programmeur Linux        STRPTIME(3)


              %j     le numéro du jour dans l'année (001-366)

              %m     le numéro du mois (1-12)

              %M     la minute (0-59)

              %p     équivalent local de AM ou PM

              %r     l'heure, ainsi : %I:%M:%S %p

              %R     l'heure, ainsi : %H:%M

              %S     les  secondes (0-61, des secondes de rattra­
                     pages sont autorisées)

              %T     l'heure, ainsi : %H:%M:%S

              %w     le numéro du jour de la  semaine  (0-6),  en
                     commençant le Dimanche.

              %x     la  date, en utilisant le format usuel de la
                     localisation.

              %X     l'heure, en utilisant le format usuel de  la
                     localisation.

              %y     l'année  sans  le siècle (0-99; Malheureuse­
                     ment cette conversion suppose que l'on  soit
                     toujours au 20ème siecle. La valeur 1900 est
                     automatiqement ajoutée).

              %Y     L'année en incluant le siècle (par  exemple,
                     1996)

       Pour  les  noms  des  mois ou des jours de la semaine, les
       différences entre majuscules et minuscules sont  ignorées.

       Les champs de la structure tm définie dans <time.h> sont :

              struct tm
              {
                int  tm_sec;   /* secondes           */
                int  tm_min;   /* minutes            */
                int  tm_hour;  /* heures             */
                int  tm_mday;  /* jour du mois       */
                int  tm_mon;   /* mois               */
                int  tm_year;  /* année              */
                int  tm_wday;  /* jour de la semaine */
                int  tm_yday;  /* jour de l'année    */
                int  tm_isdst; /* décalage été/hiver */
              };

VALEUR RENVOYÉE
       La  fonction  strptime()  renvoie  un  pointeur   sur   le



Linux                    10 Novembre 1996                       2





STRPTIME(3)        Manuel du programmeur Linux        STRPTIME(3)


       caractère  suivant  le  dernier caractère de la chaîne buf
       ayant été converti.

VOIR AUSSI
       strftime(3), time(2), setlocale(3), scanf(3)

NOTES
       Cette fonction n'est disponible que dans les  versions  de
       bibliothèque postérieures à la 4.6.5

       Seules  les  localisations  indiquées  dans locale(7) sont
       supportées.


TRADUCTION
       Christophe Blaess, 1997.









































Linux                    10 Novembre 1996                       3