cvs: phpdoc-fr /reference/datetime/functions strftime.xml
| From: | Yannick Torres | Date: | Thu, 12 Feb 2009 17:52:07 +0000 |
| Subject: | cvs: phpdoc-fr /reference/datetime/functions strftime.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6663@lists.php.net to get a copy of this message | ||
yannick Thu Feb 12 17:52:07 2009 UTC
Modified files:
/phpdoc-fr/reference/datetime/functions strftime.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/strftime.xml?r1=1.29&r2=1.30&diff_format=u Index: phpdoc-fr/reference/datetime/functions/strftime.xml diff -u phpdoc-fr/reference/datetime/functions/strftime.xml:1.29 phpdoc-fr/reference/datetime/functions/strftime.xml:1.30 --- phpdoc-fr/reference/datetime/functions/strftime.xml:1.29 Fri Jan 9 19:01:04 2009 +++ phpdoc-fr/reference/datetime/functions/strftime.xml Thu Feb 12 17:52:07 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.29 $ --> -<!-- EN-Revision: 1.26 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.30 $ --> +<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -17,7 +17,7 @@ <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam> </methodsynopsis> <para> - Formate une date/heure locale suivant la localisation locale. Les noms + Formate une date et/ou une heure suivant la localisation locale. Les noms des mois, des jours de la semaine mais aussi d'autres chaînes dépendant de la location, respecteront la localisation courante définie par la fonction <function>setlocale</function>. @@ -27,7 +27,7 @@ toutes les bibliothèques C. Dans ce cas, ils ne seront pas supportés par PHP non plus. De plus, toutes les plates-formes ne supportent pas les timestamps négatifs, et vos dates pourraient être limitées par le - début de l'époque Unix. Cela signifie que + début de l'époque Unix. Cela signifie que %e, %T, %R et %D (et peut être d'autres) et les dates antérieures au <literal>1er Janvier 1970</literal> ne fonctionneront pas sous Windows, sur certaines distributions de Linux, et sur certains systèmes d'exploitation. @@ -44,219 +44,275 @@ <term><parameter>format</parameter></term> <listitem> <para> - Les caractères suivants sont utilisés pour spécifier - le format de la date : - <itemizedlist> - <listitem> - <simpara> - %a - nom abrégé du jour de la semaine (local) - </simpara> - </listitem> - <listitem> - <simpara> - %A - nom complet du jour de la semaine (local) - </simpara> - </listitem> - <listitem> - <simpara> - %b - nom abrégé du mois (local) - </simpara> - </listitem> - <listitem> - <simpara> - %B - nom complet du mois (local) - </simpara> - </listitem> - <listitem> - <simpara> - %c - représentation préférée pour les dates et heures, en local - </simpara> - </listitem> - <listitem> - <simpara> - %C - numéro de siècle (l'année, divisée par 100 - et arrondie entre 00 et 99) - </simpara> - </listitem> - <listitem> - <simpara> - %d - jour du mois en numérique (intervalle 01 à 31) - </simpara> - </listitem> - <listitem> - <simpara> - %D - identique à %m/%d/%y - </simpara> - </listitem> - <listitem> - <simpara> - %e - numéro du jour du mois. Les chiffres sont précédés - d'un espace (de ' 1' à '31') - </simpara> - </listitem> - <listitem> - <simpara> - %g - identique à %G, sur 2 chiffres - </simpara> - </listitem> - <listitem> - <simpara> - %G - L'année sur 4 chiffres correspondant au numéro de semaine (voir %V). - Même format et valeur que %Y, excepté que si le numéro de la semaine - appartient à l'année précédente ou suivante, l'année courante sera utilisé à la place - </simpara> - </listitem> - <listitem> - <simpara> - %h - identique à %b - </simpara> - </listitem> - <listitem> - <simpara> - %H - heure de la journée en numérique, et sur 24-heures - (intervalle de 00 à 23) - </simpara> - </listitem> - <listitem> - <simpara> - %I - heure de la journée en numérique, et sur 12- heures - (intervalle 01 à 12) - </simpara> - </listitem> - <listitem> - <simpara> - %j - jour de l'année, en numérique (intervalle 001 à 366) - </simpara> - </listitem> - <listitem> - <simpara> - %m - mois en numérique (intervalle 1 à 12) - </simpara> - </listitem> - <listitem> - <simpara> - %M - minute en numérique - </simpara> - </listitem> - <listitem> - <simpara> - %n - caractère de nouvelle ligne - </simpara> - </listitem> - <listitem> - <simpara> - %p - `AM' ou `PM', en majuscule, suivant la valeur donnée, ou la chaîne - correspondante pour la locale courante - </simpara> - </listitem> - <listitem> - <simpara> - %P - `am' ou `pm', en majuscule, suivant la valeur donnée, ou la chaîne - correspondante à la locale courante - </simpara> - </listitem> - <listitem> - <simpara> - %r - l'heure au format a.m. et p.m - </simpara> - </listitem> - <listitem> - <simpara> - %R - l'heure au format 24h - </simpara> - </listitem> - <listitem> - <simpara> - %S - secondes en numérique - </simpara> - </listitem> - <listitem> - <simpara> - %t - tabulation - </simpara> - </listitem> - <listitem> - <simpara> - %T - l'heure actuelle (égal à %H:%M:%S) - </simpara> - </listitem> - <listitem> - <simpara> - %u - le numéro de jour dans la semaine, de 1 à 7. (1 représente - Lundi) - </simpara> - <warning> - <simpara> - Les systèmes Sun Solaris semblent commencer le Dimanche à 1 malgré - le fait que le standard ISO 9889:1999 (actuellement le standard C) spécifie - clairement le début de la semaine à Lundi. - </simpara> - </warning> - </listitem> - <listitem> - <simpara> - %U - numéro de semaine dans l'année, en considérant - le premier dimanche de l'année comme le premier jour de la - première semaine - </simpara> - </listitem> - <listitem> - <simpara> - %V - le numéro de semaine comme défini dans l'ISO 8601:1988, - sous forme décimale, de 01 à 53. La semaine 1 est la première - semaine qui a plus de 4 jours dans l'année courante, et dont - Lundi est le premier jour. (Utilisez %G ou %g pour les éléments de l'année - qui correspondent au numéro de la semaine pour le timestamp donné.) - </simpara> - </listitem> - <listitem> - <simpara> - %W - numéro de semaine dans l'année, en considérant - le premier lundi de l'année comme le premier jour de la - première semaine - </simpara> - </listitem> - <listitem> - <simpara> - %w - jour de la semaine, numérique, avec Dimanche = 0 - </simpara> - </listitem> - <listitem> - <simpara> - %x - format préféré de représentation de la date sans l'heure - </simpara> - </listitem> - <listitem> - <simpara> - %X - format préféré de représentation de l'heure sans la date - </simpara> - </listitem> - <listitem> - <simpara> - %y - l'année, numérique, sur deux chiffres (de 00 à 99) - </simpara> - </listitem> - <listitem> - <simpara> - %Y - l'année, numérique, sur quatre chiffres - </simpara> - </listitem> - <listitem> - <simpara> - %Z ou %z - fuseau horaire, ou nom ou abréviation (suivant le système - d'exploitation) - </simpara> - </listitem> - <listitem> - <simpara> - %% - un caractère `%' littéral - </simpara> - </listitem> - </itemizedlist> + <table> + <title>Les caractères suivants sont reconnus dans le paramètre + <parameter>format</parameter></title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>format</parameter></entry> + <entry>Description</entry> + <entry>Exemple de valeurs retournées</entry> + </row> + </thead> + <tbody> + <row> + <entry align="center"><emphasis>Jour</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%a</literal></entry> + <entry>Nom abrégé du jour de la semaine</entry> + <entry>De <literal>Sun</literal> à <literal>Sat</literal></entry> + </row> + <row> + <entry><literal>%A</literal></entry> + <entry>Nom complet du jour de la semaine</entry> + <entry>De <literal>Sunday</literal> à <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>%d</literal></entry> + <entry>Jour du mois en numérique, sur 2 chiffres (avec le zéro initial)</entry> + <entry>De <literal>01</literal> à <literal>31</literal></entry> + </row> + <row> + <entry><literal>%e</literal></entry> + <entry>Jour du mois, avec un espace précédant le premier chiffre</entry> + <entry>De <literal> 1</literal> à <literal>31</literal></entry> + </row> + <row> + <entry><literal>%j</literal></entry> + <entry>Jour de l'année, sur 3 chiffres avec un zéro initial</entry> + <entry><literal>001</literal> to <literal>366</literal></entry> + </row> + <row> + <entry><literal>%u</literal></entry> + <entry>Représentation ISO-8601 du jour de la semaine</entry> + <entry>De <literal>1</literal> (pour Lundi) à <literal>7</literal> (pour Dimanche)</entry> + </row> + <row> + <entry><literal>%w</literal></entry> + <entry>Représentation numérique du jour de la semaine</entry> + <entry>De <literal>0</literal> (pour Dimanche) à <literal>6</literal> (pour Samedi)</entry> + </row> + <row> + <entry align="center"><emphasis>Semaine</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%U</literal></entry> + <entry>Numéro de la semaine de l'année donnée, en commançant par le premier + Lundi comme première semaine</entry> + <entry><literal>13</literal> (pour la 13ème semaine pleine de l'année)</entry> + </row> + <row> + <entry><literal>%V</literal></entry> + <entry>Numéro de la semaine de l'année, suivant la norme ISO-8601:1988, + en commençant comme première semaine, la semaine de l'année contenant au moins + 4 jours, et où Lundi est le début de la semaine</entry> + <entry>De <literal>01</literal> à <literal>53</literal> (où 53 + compte comme semaine de chevauchement)</entry> + </row> + <row> + <entry><literal>%W</literal></entry> + <entry>Une représentation numérique de la semaine de l'année, en commençant + par le premier Lundi de la première semaine</entry> + <entry><literal>46</literal> (pour la 46ème semaine de la semaine commençant + par un Lundi)</entry> + </row> + <row> + <entry align="center"><emphasis>Mois</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%b</literal></entry> + <entry>Nom du mois, abrégé, suivant la locale</entry> + <entry>De <literal>Jan</literal> à <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>%B</literal></entry> + <entry>Nom complet du mois, suivant la locale</entry> + <entry>De <literal>January</literal> à <literal>December</literal></entry> + </row> + <row> + <entry><literal>%h</literal></entry> + <entry>Nom du mois abrégé, suivant la locale (alias de %b)</entry> + <entry>De <literal>Jan</literal> à <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>%m</literal></entry> + <entry>Mois, sur 2 chiffres</entry> + <entry>De <literal>01</literal> (pour Janvier) à <literal>12</literal> (pour Décembre)</entry> + </row> + <row> + <entry align="center"><emphasis>Année</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%C</literal></entry> + <entry>Représentation, sur 2 chiffres, du siècle (année divisée par 100, réduit à un entier)</entry> + <entry><literal>19</literal> pour le 20ème siècle</entry> + </row> + <row> + <entry><literal>%g</literal></entry> + <entry>Two digit representation of the year going by ISO-8601:1988 standards (see %V)</entry> + <entry>Example: <literal>09</literal> for the week of January 6, 2009</entry> + </row> + <row> + <entry><literal>%G</literal></entry> + <entry>The full four-digit version of %g</entry> + <entry>Example: <literal>2008</literal> for the week of January 3, 2009</entry> + </row> + <row> + <entry><literal>%y</literal></entry> + <entry>L'année, sur 2 chiffres</entry> + <entry>Exemple : <literal>09</literal> pour 2009, <literal>79</literal> pour 1979</entry> + </row> + <row> + <entry><literal>%Y</literal></entry> + <entry>L'année, sur 4 chiffres</entry> + <entry>Exemple : <literal>2038</literal></entry> + </row> + <row> + <entry align="center"><emphasis>Heure</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%H</literal></entry> + <entry>L'heure, sur 2 chiffres, au format 24 heures</entry> + <entry>De <literal>00</literal> à <literal>23</literal></entry> + </row> + <row> + <entry><literal>%I</literal></entry> + <entry>Heure, sur 2 chiffres, au format 12 heures</entry> + <entry>De <literal>01</literal> à <literal>12</literal></entry> + </row> + <row> + <entry><literal>%l ('L' minuscule)</literal></entry> + <entry>Heure, au format 12 heures, avec un espace précédant de complétion pour les heures sur un chiffre</entry> + <entry>De <literal> 1</literal> à <literal>12</literal></entry> + </row> + <row> + <entry><literal>%M</literal></entry> + <entry>Minute, sur 2 chiffres</entry> + <entry>De <literal>00</literal> à <literal>59</literal></entry> + </row> + <row> + <entry><literal>%p</literal></entry> + <entry>'AM' ou 'PM', en majuscule, basé sur l'heure fournie</entry> + <entry>Exemple : <literal>AM</literal> pour 00:31, <literal>PM</literal> pour 22:23</entry> + </row> + <row> + <entry><literal>%P</literal></entry> + <entry>'am' ou 'pm', en minuscule, basé sur l'heure fournie</entry> + <entry>Exemple : <literal>am</literal> pour 00:31, <literal>pm</literal> pour 22:23</entry> + </row> + <row> + <entry><literal>%r</literal></entry> + <entry>Identique à "%I:%M:%S %p"</entry> + <entry>Exemple : <literal>09:34:17 PM</literal> pour 21:34:17</entry> + </row> + <row> + <entry><literal>%R</literal></entry> + <entry>Identique à "%H:%I"</entry> + <entry>Exemple : <literal>00:35</literal> pour 12:35 AM, <literal>16:44</literal> pour 4:44 PM</entry> + </row> + <row> + <entry><literal>%S</literal></entry> + <entry>Seconde, sur 2 chiffres</entry> + <entry>De <literal>00</literal> à <literal>59</literal></entry> + </row> + <row> + <entry><literal>%T</literal></entry> + <entry>Identique à "%H:%M:%S"</entry> + <entry>Exemple : <literal>21:34:17</literal> pour 09:34:17 PM</entry> + </row> + <row> + <entry><literal>%X</literal></entry> + <entry>Représentation de l'heure, basée sur la locale, sans la date</entry> + <entry>Exemple : <literal>03:59:16</literal> ou <literal>15:59:16</literal></entry> + </row> + <row> + <entry><literal>%z</literal></entry> + <entry>Soit le décalage horaire depuis UTC, ou son abréviation (suivant le système + d'exploitation)</entry> + <entry>Exemple : <literal>-0500</literal> ou <literal>EST</literal> pour l'heure de l'Est</entry> + </row> + <row> + <entry><literal>%Z</literal></entry> + <entry>Le décalage horaire ou son abréviation NON fourni par %z (suivant le système + d'exploitation)</entry> + <entry>Exemple : <literal>-0500</literal> ou <literal>EST</literal> pour l'heure de l'Est</entry> + </row> + <row> + <entry align="center"><emphasis>L'heure et la date</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%c</literal></entry> + <entry>Date et heure préférées, basées sur la locale</entry> + <entry>Exemple : <literal>Tue Feb 5 00:45:10 2009</literal> pour + le 4 Février 2009 à 12:45:10 AM</entry> + </row> + <row> + <entry><literal>%D</literal></entry> + <entry>Identique à "%m/%d/%y"</entry> + <entry>Exemple : <literal>02/05/09</literal> pour le 5 Février 2009</entry> + </row> + <row> + <entry><literal>%F</literal></entry> + <entry>Identique à "%y-%m-%d" (utilisé habituellement par les bases de données)</entry> + <entry>Exemple : <literal>2009-02-05</literal> for February 5, 2009</entry> + </row> + <row> + <entry><literal>%s</literal></entry> + <entry>Timestamp de l'époque Unix (identique à la fonction <function>time</function>)</entry> + <entry>Exemple : <literal>305815200</literal> pour le 10 Septembre 1979 08:40:00 AM</entry> + </row> + <row> + <entry><literal>%x</literal></entry> + <entry>Représentation préférée de la date, basée sur la locale, sans l'heure</entry> + <entry>Exemple : <literal>02/05/09</literal> pour le 5 Février 2009</entry> + </row> + <row> + <entry align="center"><emphasis>Divers</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%n</literal></entry> + <entry>Une nouvelle ligne ("\n")</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%t</literal></entry> + <entry>Une tabulation ("\t")</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%%</literal></entry> + <entry>Le caractère de pourcentage ("%")</entry> + <entry>---</entry> + </row> + </tbody> + </tgroup> + </table> </para> <para> La longueur maximale de ce paramètre est de 1023 caractères. </para> + <warning> + <simpara> + Contrairement à la norme ISO-9889:1999, Sun Solaris commence avec le Dimanche à 1. + Aussi, le format %u ne fonctionnera pas tel que décrit dans ce manuel. + </simpara> + </warning> </listitem> </varlistentry> @@ -269,9 +325,9 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne une &string; formatée suivant le format donné, en utilisant - le paramètre <parameter>timestamp</parameter> ou la date locale courante - si aucun timestamp n'est fourni. Les noms des mois, des jours de la + Retourne une &string; formatée suivant le paramètre <parameter>format</parameter> + donné, en utilisant le paramètre <parameter>timestamp</parameter> ou la date locale + courante si aucun timestamp n'est fourni. Les noms des mois, des jours de la semaine mais aussi d'autres chaînes dépendant de la location, respecteront la localisation courante définie par la fonction <function>setlocale</function>. </para> @@ -383,7 +439,7 @@ <simpara> %G et %V, qui sont basées sur la semaine ISO 8601:1988, peut conduire à des résultat inattendus (bien que corrects) si le - système de numérotation n'est pas connu. Voir l'exemple + système de numérotation n'est pas connu. Voir l'exemple %V de cette page. </simpara> </note>
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/strftime.xml?r1=1.29&r2=1.30&diff_format=u Index: phpdoc-fr/reference/datetime/functions/strftime.xml diff -u phpdoc-fr/reference/datetime/functions/strftime.xml:1.29 phpdoc-fr/reference/datetime/functions/strftime.xml:1.30 --- phpdoc-fr/reference/datetime/functions/strftime.xml:1.29 Fri Jan 9 19:01:04 2009 +++ phpdoc-fr/reference/datetime/functions/strftime.xml Thu Feb 12 17:52:07 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.29 $ --> -<!-- EN-Revision: 1.26 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.30 $ --> +<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -17,7 +17,7 @@ <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam> </methodsynopsis> <para> - Formate une date/heure locale suivant la localisation locale. Les noms + Formate une date et/ou une heure suivant la localisation locale. Les noms des mois, des jours de la semaine mais aussi d'autres chaînes dépendant de la location, respecteront la localisation courante définie par la fonction <function>setlocale</function>. @@ -27,7 +27,7 @@ toutes les bibliothèques C. Dans ce cas, ils ne seront pas supportés par PHP non plus. De plus, toutes les plates-formes ne supportent pas les timestamps négatifs, et vos dates pourraient être limitées par le - début de l'époque Unix. Cela signifie que + début de l'époque Unix. Cela signifie que %e, %T, %R et %D (et peut être d'autres) et les dates antérieures au <literal>1er Janvier 1970</literal> ne fonctionneront pas sous Windows, sur certaines distributions de Linux, et sur certains systèmes d'exploitation. @@ -44,219 +44,275 @@ <term><parameter>format</parameter></term> <listitem> <para> - Les caractères suivants sont utilisés pour spécifier - le format de la date : - <itemizedlist> - <listitem> - <simpara> - %a - nom abrégé du jour de la semaine (local) - </simpara> - </listitem> - <listitem> - <simpara> - %A - nom complet du jour de la semaine (local) - </simpara> - </listitem> - <listitem> - <simpara> - %b - nom abrégé du mois (local) - </simpara> - </listitem> - <listitem> - <simpara> - %B - nom complet du mois (local) - </simpara> - </listitem> - <listitem> - <simpara> - %c - représentation préférée pour les dates et heures, en local - </simpara> - </listitem> - <listitem> - <simpara> - %C - numéro de siècle (l'année, divisée par 100 - et arrondie entre 00 et 99) - </simpara> - </listitem> - <listitem> - <simpara> - %d - jour du mois en numérique (intervalle 01 à 31) - </simpara> - </listitem> - <listitem> - <simpara> - %D - identique à %m/%d/%y - </simpara> - </listitem> - <listitem> - <simpara> - %e - numéro du jour du mois. Les chiffres sont précédés - d'un espace (de ' 1' à '31') - </simpara> - </listitem> - <listitem> - <simpara> - %g - identique à %G, sur 2 chiffres - </simpara> - </listitem> - <listitem> - <simpara> - %G - L'année sur 4 chiffres correspondant au numéro de semaine (voir %V). - Même format et valeur que %Y, excepté que si le numéro de la semaine - appartient à l'année précédente ou suivante, l'année courante sera utilisé à la place - </simpara> - </listitem> - <listitem> - <simpara> - %h - identique à %b - </simpara> - </listitem> - <listitem> - <simpara> - %H - heure de la journée en numérique, et sur 24-heures - (intervalle de 00 à 23) - </simpara> - </listitem> - <listitem> - <simpara> - %I - heure de la journée en numérique, et sur 12- heures - (intervalle 01 à 12) - </simpara> - </listitem> - <listitem> - <simpara> - %j - jour de l'année, en numérique (intervalle 001 à 366) - </simpara> - </listitem> - <listitem> - <simpara> - %m - mois en numérique (intervalle 1 à 12) - </simpara> - </listitem> - <listitem> - <simpara> - %M - minute en numérique - </simpara> - </listitem> - <listitem> - <simpara> - %n - caractère de nouvelle ligne - </simpara> - </listitem> - <listitem> - <simpara> - %p - `AM' ou `PM', en majuscule, suivant la valeur donnée, ou la chaîne - correspondante pour la locale courante - </simpara> - </listitem> - <listitem> - <simpara> - %P - `am' ou `pm', en majuscule, suivant la valeur donnée, ou la chaîne - correspondante à la locale courante - </simpara> - </listitem> - <listitem> - <simpara> - %r - l'heure au format a.m. et p.m - </simpara> - </listitem> - <listitem> - <simpara> - %R - l'heure au format 24h - </simpara> - </listitem> - <listitem> - <simpara> - %S - secondes en numérique - </simpara> - </listitem> - <listitem> - <simpara> - %t - tabulation - </simpara> - </listitem> - <listitem> - <simpara> - %T - l'heure actuelle (égal à %H:%M:%S) - </simpara> - </listitem> - <listitem> - <simpara> - %u - le numéro de jour dans la semaine, de 1 à 7. (1 représente - Lundi) - </simpara> - <warning> - <simpara> - Les systèmes Sun Solaris semblent commencer le Dimanche à 1 malgré - le fait que le standard ISO 9889:1999 (actuellement le standard C) spécifie - clairement le début de la semaine à Lundi. - </simpara> - </warning> - </listitem> - <listitem> - <simpara> - %U - numéro de semaine dans l'année, en considérant - le premier dimanche de l'année comme le premier jour de la - première semaine - </simpara> - </listitem> - <listitem> - <simpara> - %V - le numéro de semaine comme défini dans l'ISO 8601:1988, - sous forme décimale, de 01 à 53. La semaine 1 est la première - semaine qui a plus de 4 jours dans l'année courante, et dont - Lundi est le premier jour. (Utilisez %G ou %g pour les éléments de l'année - qui correspondent au numéro de la semaine pour le timestamp donné.) - </simpara> - </listitem> - <listitem> - <simpara> - %W - numéro de semaine dans l'année, en considérant - le premier lundi de l'année comme le premier jour de la - première semaine - </simpara> - </listitem> - <listitem> - <simpara> - %w - jour de la semaine, numérique, avec Dimanche = 0 - </simpara> - </listitem> - <listitem> - <simpara> - %x - format préféré de représentation de la date sans l'heure - </simpara> - </listitem> - <listitem> - <simpara> - %X - format préféré de représentation de l'heure sans la date - </simpara> - </listitem> - <listitem> - <simpara> - %y - l'année, numérique, sur deux chiffres (de 00 à 99) - </simpara> - </listitem> - <listitem> - <simpara> - %Y - l'année, numérique, sur quatre chiffres - </simpara> - </listitem> - <listitem> - <simpara> - %Z ou %z - fuseau horaire, ou nom ou abréviation (suivant le système - d'exploitation) - </simpara> - </listitem> - <listitem> - <simpara> - %% - un caractère `%' littéral - </simpara> - </listitem> - </itemizedlist> + <table> + <title>Les caractères suivants sont reconnus dans le paramètre + <parameter>format</parameter></title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>format</parameter></entry> + <entry>Description</entry> + <entry>Exemple de valeurs retournées</entry> + </row> + </thead> + <tbody> + <row> + <entry align="center"><emphasis>Jour</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%a</literal></entry> + <entry>Nom abrégé du jour de la semaine</entry> + <entry>De <literal>Sun</literal> à <literal>Sat</literal></entry> + </row> + <row> + <entry><literal>%A</literal></entry> + <entry>Nom complet du jour de la semaine</entry> + <entry>De <literal>Sunday</literal> à <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>%d</literal></entry> + <entry>Jour du mois en numérique, sur 2 chiffres (avec le zéro initial)</entry> + <entry>De <literal>01</literal> à <literal>31</literal></entry> + </row> + <row> + <entry><literal>%e</literal></entry> + <entry>Jour du mois, avec un espace précédant le premier chiffre</entry> + <entry>De <literal> 1</literal> à <literal>31</literal></entry> + </row> + <row> + <entry><literal>%j</literal></entry> + <entry>Jour de l'année, sur 3 chiffres avec un zéro initial</entry> + <entry><literal>001</literal> to <literal>366</literal></entry> + </row> + <row> + <entry><literal>%u</literal></entry> + <entry>Représentation ISO-8601 du jour de la semaine</entry> + <entry>De <literal>1</literal> (pour Lundi) à <literal>7</literal> (pour Dimanche)</entry> + </row> + <row> + <entry><literal>%w</literal></entry> + <entry>Représentation numérique du jour de la semaine</entry> + <entry>De <literal>0</literal> (pour Dimanche) à <literal>6</literal> (pour Samedi)</entry> + </row> + <row> + <entry align="center"><emphasis>Semaine</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%U</literal></entry> + <entry>Numéro de la semaine de l'année donnée, en commançant par le premier + Lundi comme première semaine</entry> + <entry><literal>13</literal> (pour la 13ème semaine pleine de l'année)</entry> + </row> + <row> + <entry><literal>%V</literal></entry> + <entry>Numéro de la semaine de l'année, suivant la norme ISO-8601:1988, + en commençant comme première semaine, la semaine de l'année contenant au moins + 4 jours, et où Lundi est le début de la semaine</entry> + <entry>De <literal>01</literal> à <literal>53</literal> (où 53 + compte comme semaine de chevauchement)</entry> + </row> + <row> + <entry><literal>%W</literal></entry> + <entry>Une représentation numérique de la semaine de l'année, en commençant + par le premier Lundi de la première semaine</entry> + <entry><literal>46</literal> (pour la 46ème semaine de la semaine commençant + par un Lundi)</entry> + </row> + <row> + <entry align="center"><emphasis>Mois</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%b</literal></entry> + <entry>Nom du mois, abrégé, suivant la locale</entry> + <entry>De <literal>Jan</literal> à <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>%B</literal></entry> + <entry>Nom complet du mois, suivant la locale</entry> + <entry>De <literal>January</literal> à <literal>December</literal></entry> + </row> + <row> + <entry><literal>%h</literal></entry> + <entry>Nom du mois abrégé, suivant la locale (alias de %b)</entry> + <entry>De <literal>Jan</literal> à <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>%m</literal></entry> + <entry>Mois, sur 2 chiffres</entry> + <entry>De <literal>01</literal> (pour Janvier) à <literal>12</literal> (pour Décembre)</entry> + </row> + <row> + <entry align="center"><emphasis>Année</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%C</literal></entry> + <entry>Représentation, sur 2 chiffres, du siècle (année divisée par 100, réduit à un entier)</entry> + <entry><literal>19</literal> pour le 20ème siècle</entry> + </row> + <row> + <entry><literal>%g</literal></entry> + <entry>Two digit representation of the year going by ISO-8601:1988 standards (see %V)</entry> + <entry>Example: <literal>09</literal> for the week of January 6, 2009</entry> + </row> + <row> + <entry><literal>%G</literal></entry> + <entry>The full four-digit version of %g</entry> + <entry>Example: <literal>2008</literal> for the week of January 3, 2009</entry> + </row> + <row> + <entry><literal>%y</literal></entry> + <entry>L'année, sur 2 chiffres</entry> + <entry>Exemple : <literal>09</literal> pour 2009, <literal>79</literal> pour 1979</entry> + </row> + <row> + <entry><literal>%Y</literal></entry> + <entry>L'année, sur 4 chiffres</entry> + <entry>Exemple : <literal>2038</literal></entry> + </row> + <row> + <entry align="center"><emphasis>Heure</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%H</literal></entry> + <entry>L'heure, sur 2 chiffres, au format 24 heures</entry> + <entry>De <literal>00</literal> à <literal>23</literal></entry> + </row> + <row> + <entry><literal>%I</literal></entry> + <entry>Heure, sur 2 chiffres, au format 12 heures</entry> + <entry>De <literal>01</literal> à <literal>12</literal></entry> + </row> + <row> + <entry><literal>%l ('L' minuscule)</literal></entry> + <entry>Heure, au format 12 heures, avec un espace précédant de complétion pour les heures sur un chiffre</entry> + <entry>De <literal> 1</literal> à <literal>12</literal></entry> + </row> + <row> + <entry><literal>%M</literal></entry> + <entry>Minute, sur 2 chiffres</entry> + <entry>De <literal>00</literal> à <literal>59</literal></entry> + </row> + <row> + <entry><literal>%p</literal></entry> + <entry>'AM' ou 'PM', en majuscule, basé sur l'heure fournie</entry> + <entry>Exemple : <literal>AM</literal> pour 00:31, <literal>PM</literal> pour 22:23</entry> + </row> + <row> + <entry><literal>%P</literal></entry> + <entry>'am' ou 'pm', en minuscule, basé sur l'heure fournie</entry> + <entry>Exemple : <literal>am</literal> pour 00:31, <literal>pm</literal> pour 22:23</entry> + </row> + <row> + <entry><literal>%r</literal></entry> + <entry>Identique à "%I:%M:%S %p"</entry> + <entry>Exemple : <literal>09:34:17 PM</literal> pour 21:34:17</entry> + </row> + <row> + <entry><literal>%R</literal></entry> + <entry>Identique à "%H:%I"</entry> + <entry>Exemple : <literal>00:35</literal> pour 12:35 AM, <literal>16:44</literal> pour 4:44 PM</entry> + </row> + <row> + <entry><literal>%S</literal></entry> + <entry>Seconde, sur 2 chiffres</entry> + <entry>De <literal>00</literal> à <literal>59</literal></entry> + </row> + <row> + <entry><literal>%T</literal></entry> + <entry>Identique à "%H:%M:%S"</entry> + <entry>Exemple : <literal>21:34:17</literal> pour 09:34:17 PM</entry> + </row> + <row> + <entry><literal>%X</literal></entry> + <entry>Représentation de l'heure, basée sur la locale, sans la date</entry> + <entry>Exemple : <literal>03:59:16</literal> ou <literal>15:59:16</literal></entry> + </row> + <row> + <entry><literal>%z</literal></entry> + <entry>Soit le décalage horaire depuis UTC, ou son abréviation (suivant le système + d'exploitation)</entry> + <entry>Exemple : <literal>-0500</literal> ou <literal>EST</literal> pour l'heure de l'Est</entry> + </row> + <row> + <entry><literal>%Z</literal></entry> + <entry>Le décalage horaire ou son abréviation NON fourni par %z (suivant le système + d'exploitation)</entry> + <entry>Exemple : <literal>-0500</literal> ou <literal>EST</literal> pour l'heure de l'Est</entry> + </row> + <row> + <entry align="center"><emphasis>L'heure et la date</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%c</literal></entry> + <entry>Date et heure préférées, basées sur la locale</entry> + <entry>Exemple : <literal>Tue Feb 5 00:45:10 2009</literal> pour + le 4 Février 2009 à 12:45:10 AM</entry> + </row> + <row> + <entry><literal>%D</literal></entry> + <entry>Identique à "%m/%d/%y"</entry> + <entry>Exemple : <literal>02/05/09</literal> pour le 5 Février 2009</entry> + </row> + <row> + <entry><literal>%F</literal></entry> + <entry>Identique à "%y-%m-%d" (utilisé habituellement par les bases de données)</entry> + <entry>Exemple : <literal>2009-02-05</literal> for February 5, 2009</entry> + </row> + <row> + <entry><literal>%s</literal></entry> + <entry>Timestamp de l'époque Unix (identique à la fonction <function>time</function>)</entry> + <entry>Exemple : <literal>305815200</literal> pour le 10 Septembre 1979 08:40:00 AM</entry> + </row> + <row> + <entry><literal>%x</literal></entry> + <entry>Représentation préférée de la date, basée sur la locale, sans l'heure</entry> + <entry>Exemple : <literal>02/05/09</literal> pour le 5 Février 2009</entry> + </row> + <row> + <entry align="center"><emphasis>Divers</emphasis></entry> + <entry>---</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%n</literal></entry> + <entry>Une nouvelle ligne ("\n")</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%t</literal></entry> + <entry>Une tabulation ("\t")</entry> + <entry>---</entry> + </row> + <row> + <entry><literal>%%</literal></entry> + <entry>Le caractère de pourcentage ("%")</entry> + <entry>---</entry> + </row> + </tbody> + </tgroup> + </table> </para> <para> La longueur maximale de ce paramètre est de 1023 caractères. </para> + <warning> + <simpara> + Contrairement à la norme ISO-9889:1999, Sun Solaris commence avec le Dimanche à 1. + Aussi, le format %u ne fonctionnera pas tel que décrit dans ce manuel. + </simpara> + </warning> </listitem> </varlistentry> @@ -269,9 +325,9 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne une &string; formatée suivant le format donné, en utilisant - le paramètre <parameter>timestamp</parameter> ou la date locale courante - si aucun timestamp n'est fourni. Les noms des mois, des jours de la + Retourne une &string; formatée suivant le paramètre <parameter>format</parameter> + donné, en utilisant le paramètre <parameter>timestamp</parameter> ou la date locale + courante si aucun timestamp n'est fourni. Les noms des mois, des jours de la semaine mais aussi d'autres chaînes dépendant de la location, respecteront la localisation courante définie par la fonction <function>setlocale</function>. </para> @@ -383,7 +439,7 @@ <simpara> %G et %V, qui sont basées sur la semaine ISO 8601:1988, peut conduire à des résultat inattendus (bien que corrects) si le - système de numérotation n'est pas connu. Voir l'exemple + système de numérotation n'est pas connu. Voir l'exemple %V de cette page. </simpara> </note>