cvs: phpdoc /fr/functions datetime.xml
| From: | Damien Seguy | Date: | Mon, 02 Jul 2001 10:21:41 +0000 |
| Subject: | cvs: phpdoc /fr/functions datetime.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969335800@lists.php.net to get a copy of this message | ||
dams Mon Jul 2 06:21:41 2001 EDT
Modified files:
/phpdoc/fr/functions datetime.xml
Log:
Updated checkdate, date.
Index: phpdoc/fr/functions/datetime.xml diff -u phpdoc/fr/functions/datetime.xml:1.19 phpdoc/fr/functions/datetime.xml:1.20 --- phpdoc/fr/functions/datetime.xml:1.19 Mon Apr 23 14:23:28 2001 +++ phpdoc/fr/functions/datetime.xml Mon Jul 2 06:21:40 2001 @@ -1,273 +1,275 @@ - <reference id="ref.datetime"> - <title>Dates et heures</title> - <titleabbrev>Date/heure</titleabbrev> - <refentry id="function.checkdate"> - <refnamediv> - <refname>checkdate</refname> - <refpurpose>Valide une date/heure.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>checkdate</function></funcdef> - <paramdef>int <parameter>month</parameter></paramdef> - <paramdef>int <parameter>day</parameter></paramdef> - <paramdef>int <parameter>year</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>checkdate</function> retourne <literal>TRUE</literal> - si la date - <parameter>day</parameter>/<parameter>month</parameter>/<parameter>year</parameter> - est valide, et sinon <literal>FALSE</literal>. - Notez bien que l'ordre des arguments n'est pas l'ordre français. - La date est considérée comme valide si : - <itemizedlist> - <listitem> - <simpara> - L'année est comprise entre entre 0 et 32767 inclus - </simpara> - </listitem> - <listitem> - <simpara> - Le mois est compris entre 1 et 12 inclus - </simpara> - </listitem> - <listitem> - <simpara> - Le jour est compris dans l'intervalle de date du mois. - Les années bissextiles sont prises en compte. - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.date"> - <refnamediv> - <refname>date</refname> - <refpurpose>Formate une date/heure locale</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>date</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter> - <optional>timestamp</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>date</function> retourne une date sous forme d'une chaîne, au format - donné par la chaîne format. La date est fournie - sous la forme d'un <parameter>timestamp</parameter>. Par défaut, - la date courante est utilisée. - </para> - <para> - Les caractères suivants sont utilisés pour - spécifier le format : - <itemizedlist> - <listitem> - <simpara> - a - "am" (matin) ou "pm" (après-midi) - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" (matin) ou "PM" (après-midi) - </simpara> - </listitem> - <listitem> - <simpara> - B - Heure Internet Swatch - </simpara> - </listitem> - <listitem> - <simpara> - d - Jour du mois, sur deux chiffres (éventuellement avec un zéro) : - "01" à "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - Jour de la semaine, en trois lettres (et en anglais) : par exemple - "Fri" (pour Vendredi) - </simpara> - </listitem> - <listitem> - <simpara> - F - Mois, textuel, version longue; en anglais, i.e. - "January" (pour Janvier) - </simpara> - </listitem> - <listitem> - <simpara> - g - Heure, au format 12h, sans les zéros initiaux - i.e. "1" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - Heure, au format 24h, sans les zéros initiaux - i.e. "0" à "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - Heure, au format 12h, "01" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - heure, au format 24h, "00" à "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - Minutes; "00" à "59" - </simpara> - </listitem> - <listitem> - <simpara> - I (i majuscule) - "1" si l'heure d'hivers est activée, "0" sinon. - </simpara> - </listitem> - <listitem> - <simpara> - j - Jour du mois sans les zéros initiaux: "1" à "31" - </simpara> - </listitem> - <listitem> - <simpara> - l - ('L' minuscule) - Jour de la semaine, textuel, version longue; - en anglais, i.e. "Friday" (pour Vendredi) - </simpara> - </listitem> - <listitem> - <simpara> - L - Booléen pour savoir si l'année est bissextile ("1") ou pas ("0") - </simpara> - </listitem> - <listitem> - <simpara> - m - - Mois; i.e. "01" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - Mois, en trois lettres (et en anglais) : par exemple "Apr" (pour Avril) - </simpara> - </listitem> - <listitem> - <simpara> - n - Mois sans les zéros initiaux; i.e. "1" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - r - Format de date RFC 822; i.e. "Thu, 21 Dec 2000 16:01:07 +0200" - (ajouté en PHP 4.0.4) - </simpara> - </listitem> - <listitem> - <simpara> - s - Secondes; i.e. "00" à "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - Suffixe ordinal d'un nombre, en anglais, sur deux lettres : - i.e. "th", "nd" - </simpara> - </listitem> - <listitem> - <simpara> - t - Nombre de jour dans le mois donné, i.e. "28" à "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - Fuseau horaire de la machine ; i.e. "MET" - </simpara> - </listitem> - <listitem> - <simpara> - U - Secondes depuis une époque - </simpara> - </listitem> - <listitem> - <simpara> - w - Jour de la semaine, numérique, i.e. "0" (Dimanche) to "6" (Samedi) - </simpara> - </listitem> - <listitem> - <simpara> - Y - Année, 4 chiffres; i.e. "1999" - </simpara> - </listitem> - <listitem> - <simpara> - y - Année, 2 chiffres; i.e. "99" - </simpara> - </listitem> - <listitem> - <simpara> - z - Jour de l'année; i.e. "0" à "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - Décalage horaire en secondes (i.e. "-43200" à "43200") - </simpara> - </listitem> - </itemizedlist> - Les caractères non reconnus seront imprimés tels quel. - "Z" retournera toujours "0" lorsqu'il est utilisé avec - <function>gmdate</function>. - <example> - <title>Exemple avec <function>date</function></title> - <programlisting role="php"> +<reference id="ref.datetime"> + <title>Dates et heures</title> + <titleabbrev>Date/heure</titleabbrev> + <refentry id="function.checkdate"> + <refnamediv> + <refname>checkdate</refname> + <refpurpose>Valide une date/heure.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>checkdate</function></funcdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>checkdate</function> retourne <literal>TRUE</literal> + si la date + <parameter>day</parameter>/<parameter>month</parameter>/<parameter>year</parameter> + est valide, et sinon <literal>FALSE</literal>. + Notez bien que l'ordre des arguments n'est pas l'ordre français. + La date est considérée comme valide si : + <itemizedlist> + <listitem> + <simpara> + L'année est comprise entre entre 1 et 32767 inclus. + (pour les versions antérieures à PHP 4.0.3, les années inférieures à + 1 étaient aussi valides). + </simpara> + </listitem> + <listitem> + <simpara> + Le mois est compris entre 1 et 12 inclus + </simpara> + </listitem> + <listitem> + <simpara> + Le jour est compris dans l'intervalle de dates du mois. + Les années bissextiles sont prises en compte. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.date"> + <refnamediv> + <refname>date</refname> + <refpurpose>Formate une date/heure locale</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>date</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter> + <optional>timestamp</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>date</function> retourne une date sous forme d'une chaîne, au format + donné par la chaîne format. La date est fournie + sous la forme d'un <parameter>timestamp</parameter>. Par défaut, + la date courante est utilisée. + </para> + <para> + Les caractères suivants sont utilisés pour + spécifier le format : + <itemizedlist> + <listitem> + <simpara> + a - "am" (matin) ou "pm" (après-midi) + </simpara> + </listitem> + <listitem> + <simpara> + A - "AM" (matin) ou "PM" (après-midi) + </simpara> + </listitem> + <listitem> + <simpara> + B - Heure Internet Swatch + </simpara> + </listitem> + <listitem> + <simpara> + d - Jour du mois, sur deux chiffres (éventuellement avec un zéro) : + "01" à "31" + </simpara> + </listitem> + <listitem> + <simpara> + D - Jour de la semaine, en trois lettres (et en anglais) : par exemple + "Fri" (pour Vendredi) + </simpara> + </listitem> + <listitem> + <simpara> + F - Mois, textuel, version longue; en anglais, i.e. + "January" (pour Janvier) + </simpara> + </listitem> + <listitem> + <simpara> + g - Heure, au format 12h, sans les zéros initiaux + i.e. "1" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + G - Heure, au format 24h, sans les zéros initiaux + i.e. "0" à "23" + </simpara> + </listitem> + <listitem> + <simpara> + h - Heure, au format 12h, "01" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + H - heure, au format 24h, "00" à "23" + </simpara> + </listitem> + <listitem> + <simpara> + i - Minutes; "00" à "59" + </simpara> + </listitem> + <listitem> + <simpara> + I (i majuscule) - "1" si l'heure d'été est activée, "0" si l'heure d'hiver . + </simpara> + </listitem> + <listitem> + <simpara> + j - Jour du mois sans les zéros initiaux: "1" à "31" + </simpara> + </listitem> + <listitem> + <simpara> + l - ('L' minuscule) - Jour de la semaine, textuel, version longue; + en anglais, i.e. "Friday" (pour Vendredi) + </simpara> + </listitem> + <listitem> + <simpara> + L - Booléen pour savoir si l'année est bissextile ("1") ou pas ("0") + </simpara> + </listitem> + <listitem> + <simpara> + m - Mois; i.e. "01" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + M - Mois, en trois lettres (et en anglais) : par exemple "Apr" (pour Avril) + </simpara> + </listitem> + <listitem> + <simpara> + n - Mois sans les zéros initiaux; i.e. "1" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + r - Format de date RFC 822; i.e. "Thu, 21 Dec 2000 16:01:07 +0200" + (ajouté en PHP 4.0.4) + </simpara> + </listitem> + <listitem> + <simpara> + s - Secondes; i.e. "00" à "59" + </simpara> + </listitem> + <listitem> + <simpara> + S - Suffixe ordinal d'un nombre, en anglais, sur deux lettres : + i.e. "th", "nd" + </simpara> + </listitem> + <listitem> + <simpara> + t - Nombre de jours dans le mois donné, i.e. "28" à "31" + </simpara> + </listitem> + <listitem> + <simpara> + T - Fuseau horaire de la machine ; i.e. "MET" + </simpara> + </listitem> + <listitem> + <simpara> + U - Secondes depuis une époque + </simpara> + </listitem> + <listitem> + <simpara> + w - Jour de la semaine, numérique, i.e. "0" (Dimanche) to "6" (Samedi) + </simpara> + </listitem> + <listitem> + <simpara> + Y - Année, 4 chiffres; i.e. "1999" + </simpara> + </listitem> + <listitem> + <simpara> + y - Année, 2 chiffres; i.e. "99" + </simpara> + </listitem> + <listitem> + <simpara> + z - Jour de l'année; i.e. "0" à "365" + </simpara> + </listitem> + <listitem> + <simpara> + Z - Décalage horaire en secondes (i.e. "-43200" à "43200") + </simpara> + </listitem> + </itemizedlist> + Les caractères non reconnus seront imprimés tels quel. + "Z" retournera toujours "0" lorsqu'il est utilisé avec + <function>gmdate</function>. + <example> + <title>Exemple avec <function>date</function></title> + <programlisting role="php"> print (date("l dS of F Y h:i:s A")); print ("July 1, 2000 is on a " . date("l", mktime(0,0,0,7,1,2000))); - </programlisting> - </example> - </para> - <para> - Il est possible d'utiliser <function>date</function> et - <function>mktime</function> ensemble pour génèrer - des dates dans futur ou dans passé. - <example> - <title> - Exemples avec <function>date</function> et <function>mktime</function> - </title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Il est possible d'utiliser <function>date</function> et + <function>mktime</function> ensemble pour générer + des dates dans le futur ou dans le passé. + <example> + <title> + Exemples avec <function>date</function> et <function>mktime</function> + </title> + <programlisting role="php"> <?php $tomorrow = mktime(0,0,0,date("m") ,date("d") + 1,date("Y") ); $lastmonth = mktime(0,0,0,date("m")-1,date("d") ,date("Y") ); $nextyear = mktime(0,0,0,date("m"), date("d") ,date("Y") + 1); ?> - </programlisting> - </example> - </para> - <para> - Voici maintenant quelques exemples de formattages avec - <function>date</function>. Notez que vous devriez échapper tous - les autres caractères, car s'ils ont une signification - spéciale, ils risquent de produire des effets secondaires - indésirables. Notez aussi que les versions futures de PHP - peuvent attribuer une signification à des lettres qui sont - actuellement inertes. Lorsque vous échappez les caractères, - pensez à utiiser des guillemets simples, pour que les - séquences <literal>\n</literal> ne deviennent pas des - nouvelles lignes. - <example> - <title>Formattage avec <function>date</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voici maintenant quelques exemples de formatages avec + <function>date</function>. Notez que vous devriez échapper tous + les autres caractères, car s'ils ont une signification + spéciale, ils risquent de produire des effets secondaires + indésirables. Notez aussi que les versions futures de PHP + peuvent attribuer une signification à des lettres qui sont + actuellement inertes. Lorsque vous échappez les caractères, + pensez à utiiser des guillemets simples, pour que les + séquences <literal>\n</literal> ne deviennent pas des + nouvelles lignes. + <example> + <title>Formatage avec <function>date</function></title> + <programlisting role="php"> <?php /* Aujourd'hui, le 12 Mars 2001, 10:16:18 pm */ $aujourdhui = date("F j, Y, g:i a"); // March 12, 2001, 10:16 pm @@ -283,93 +285,95 @@ $aujourdhui = date("d/m/y"); // 12/03/01 $aujourdhui = date("d/m/Y"); // 12/03/2001 ?> - </programlisting> - </example> - </para> - <para> - Pour formater des dates dans d'autres langues, utilisez les fonctions - <function>setlocale</function> et <function>strftime</function>. - </para> - <para> - Voir aussi <function>gmdate</function> et <function>mktime</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.getdate"> - <refnamediv> - <refname>getdate</refname> - <refpurpose>Retourne la date/heure</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>getdate</function></funcdef> - <paramdef>int - <parameter><optional>timestamp</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>getdate</function> retourne un tableau associatif contenant les informations - de date et heure du timestamp <parameter>timestamp</parameter> (lorsqu'il est fourni), - avec les champs suivants : - <itemizedlist> - <listitem> - <simpara> - "seconds" - secondes - </simpara> - </listitem> - <listitem> - <simpara> - "minutes" - minutes - </simpara> - </listitem> - <listitem> - <simpara> - "hours" - heures - </simpara> - </listitem> - <listitem> - <simpara> - "mday" - jour du mois - </simpara> - </listitem> - <listitem> - <simpara> - "wday" - jour de la semaine, numérique. 0: dimanche jusqu'à 6: samedi - </simpara> - </listitem> - <listitem> - <simpara> - "mon" - mois, numérique - </simpara> - </listitem> - <listitem> - <simpara> - "year" - année, numérique - </simpara> - </listitem> - <listitem> - <simpara> - "yday" - jour de l'année, numérique; i.e. "299" - </simpara> - </listitem> - <listitem> - <simpara> - "weekday" - jour de la semaine, texte complet (en anglais); i.e. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - "month" - mois, texte complet (en anglais); i.e. "January" - </simpara> - </listitem> - </itemizedlist> - </para> - <example> - <title>Exemple avec <function>getdate</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Pour formater des dates dans d'autres langues, utilisez les fonctions + <function>setlocale</function> et <function>strftime</function>. + </para> + <para> + Voir aussi + <function>gmdate</function> et + <function>mktime</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getdate"> + <refnamediv> + <refname>getdate</refname> + <refpurpose>Retourne la date/heure</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>getdate</function></funcdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getdate</function> retourne un tableau associatif contenant les informations + de date et d'heure du timestamp <parameter>timestamp</parameter> (lorsqu'il est fourni), + avec les champs suivants : + <itemizedlist> + <listitem> + <simpara> + "seconds" - secondes + </simpara> + </listitem> + <listitem> + <simpara> + "minutes" - minutes + </simpara> + </listitem> + <listitem> + <simpara> + "hours" - heures + </simpara> + </listitem> + <listitem> + <simpara> + "mday" - jour du mois + </simpara> + </listitem> + <listitem> + <simpara> + "wday" - jour de la semaine, numérique. 0: dimanche jusqu'à 6: samedi + </simpara> + </listitem> + <listitem> + <simpara> + "mon" - mois, numérique + </simpara> + </listitem> + <listitem> + <simpara> + "year" - année, numérique + </simpara> + </listitem> + <listitem> + <simpara> + "yday" - jour de l'année, numérique; i.e. "299" + </simpara> + </listitem> + <listitem> + <simpara> + "weekday" - jour de la semaine, texte complet (en anglais); i.e. "Friday" + </simpara> + </listitem> + <listitem> + <simpara> + "month" - mois, texte complet (en anglais); i.e. "January" + </simpara> + </listitem> + </itemizedlist> + </para> + <example> + <title>Exemple avec <function>getdate</function></title> + <programlisting role="php"> <?php $aujourdhui = getdate(); $mois = $aujourdhui['month']; @@ -377,273 +381,276 @@ $annee = $aujourdhui['year']; echo "$mjour/$mois/$annee"; ?> - </programlisting> - </example> - </refsect1> - </refentry> - <refentry id="function.gettimeofday"> - <refnamediv> - <refname>gettimeofday</refname> - <refpurpose>Retourne l'heure actuelle </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>gettimeofday</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>gettimeofday</function> est une interface vers gettimeofday(2). Elle - retourne un tableau associatif qui contient les informations retournées - par le système : - <itemizedlist> - <listitem> - <simpara> - "sec" - secondes - </simpara> - </listitem> - <listitem> - <simpara> - "usec" - microsecondes - </simpara> - </listitem> - <listitem> - <simpara> - "minuteswest" - minutes de décalage par rapport à Greenwich, - vers l'Ouest. - </simpara> - </listitem> - <listitem> - <simpara> - "dsttime" - type de correction dst - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.gmdate"> - <refnamediv> - <refname>gmdate</refname> - <refpurpose>Formate une date/heure GMT/CUT.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>gmdate</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter><optional>timestamp</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>gmdate</function> est identique à la fonction <function>date</function>, - hormis le fait que le temps retourné est GMT (Greenwich Mean Time) Par exemple, - en Finlande (GMT +0200), la première ligne ci-dessous affiche - "Jan 01 1998 00:00:00", tandis que la seconde "Dec 31 1997 22:00:00". - <example> - <title>Exemple avec <function>gmdate</function></title> - <programlisting role="php"> + </programlisting> + </example> + </refsect1> + </refentry> + <refentry id="function.gettimeofday"> + <refnamediv> + <refname>gettimeofday</refname> + <refpurpose>Retourne l'heure actuelle </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>gettimeofday</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gettimeofday</function> est une interface vers gettimeofday(2). Elle + retourne un tableau associatif qui contient les informations retournées + par le système : + <itemizedlist> + <listitem> + <simpara> + "sec" - secondes + </simpara> + </listitem> + <listitem> + <simpara> + "usec" - microsecondes + </simpara> + </listitem> + <listitem> + <simpara> + "minuteswest" - minutes de décalage par rapport à Greenwich, + vers l'Ouest. + </simpara> + </listitem> + <listitem> + <simpara> + "dsttime" - type de correction dst + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.gmdate"> + <refnamediv> + <refname>gmdate</refname> + <refpurpose>Formate une date/heure GMT/CUT.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gmdate</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gmdate</function> est identique à la fonction <function>date</function>, + hormis le fait que le temps retourné est GMT (Greenwich Mean Time) Par exemple, + en Finlande (GMT +0200), la première ligne ci-dessous affiche + "Jan 01 1998 00:00:00", tandis que la seconde "Dec 31 1997 22:00:00". + <example> + <title>Exemple avec <function>gmdate</function></title> + <programlisting role="php"> <?php echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>date</function>, <function>mktime</function>, - et <function>gmmktime</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.gmmktime"> - <refnamediv> - <refname>gmmktime</refname> - <refpurpose>Retourne le timestamp UNIX d'une date GMT.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>gmmktime</function></funcdef> - <paramdef>int <parameter>hour</parameter></paramdef> - <paramdef>int <parameter>minute</parameter></paramdef> - <paramdef>int <parameter>second</parameter></paramdef> - <paramdef>int <parameter>month</parameter></paramdef> - <paramdef>int <parameter>day</parameter></paramdef> - <paramdef>int <parameter>year</parameter></paramdef> - <paramdef>int - <parameter><optional>is_dst</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Identique à <function>mktime</function> hormis le fait que - les paramètres passés sont GMT. - </para> - </refsect1> - </refentry> - <refentry id="function.gmstrftime"> - <refnamediv> - <refname>gmstrftime</refname> - <refpurpose> - Formate une date/heure GMT/CUT en fonction des paramétrages locaux. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>gmstrftime</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter><optional>timestamp</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>gmstrftime</function> se comporte exactement comme - <function>strftime</function> hormis le fait l'heure utilisée - est celle de Greenwich (Greenwich Mean Time (GMT)). Par exemple, dans - la zone Eastern Standard Time (est des USA) (GMT -0500), la - première ligne de l'exemple ci dessous affiche - "Dec 31 1998 20:00:00", tandis que la seconde affiche "Jan 01 1999 01:00:00". - <example> - <title>Exemple avec <function>gmstrftime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function>, + <function>mktime</function> et + <function>gmmktime</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.gmmktime"> + <refnamediv> + <refname>gmmktime</refname> + <refpurpose>Retourne le timestamp UNIX d'une date GMT.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>gmmktime</function></funcdef> + <paramdef>int <parameter>hour</parameter></paramdef> + <paramdef>int <parameter>minute</parameter></paramdef> + <paramdef>int <parameter>second</parameter></paramdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + <paramdef>int + <parameter><optional>is_dst</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Identique à <function>mktime</function> hormis le fait que + les paramètres passés sont GMT. + </para> + </refsect1> + </refentry> + <refentry id="function.gmstrftime"> + <refnamediv> + <refname>gmstrftime</refname> + <refpurpose> + Formate une date/heure GMT/CUT en fonction des paramétrages locaux. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gmstrftime</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gmstrftime</function> se comporte exactement comme + <function>strftime</function> hormis le fait que l'heure utilisée + est celle de Greenwich (Greenwich Mean Time (GMT)). Par exemple, dans + la zone Eastern Standard Time (est des USA) (GMT -0500), la + première ligne de l'exemple ci-dessous affiche + "Dec 31 1998 20:00:00", tandis que la seconde affiche "Jan 01 1999 01:00:00". + <example> + <title>Exemple avec <function>gmstrftime</function></title> + <programlisting role="php"> <?php setlocale ('LC_TIME', 'en_US'); echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>strftime</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.localtime"> - <refnamediv> - <refname>localtime</refname> - <refpurpose>Lit l'heure locale</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>localtime</function></funcdef> - <paramdef>int - <parameter> - <optional>timestamp</optional> - </parameter> - </paramdef> - <paramdef>bool - <parameter> - <optional>is_associative</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>localtime</function> retourne un tableau identique à - la structure retournée par la fonction C localtime. Le premier - argument <parameter>timestamp</parameter> est un timestamp - UNIX. S'il n'est pas fourni, l'heure courante est utilisée. - Le second argument <parameter>is_associative</parameter>, s'il - est mis à 0 ou ignoré, force <function>localtime</function> - a retourner un tableau à index numérique. S'il est mis à 1, - <function>localtime</function> retourne un tableau associatif, - avec tous les éléments de la structure C, accessible avec les clés - suivantes : - <itemizedlist> - <listitem> - <simpara> - "tm_sec" - secondes - </simpara> - </listitem> - <listitem> - <simpara> - "tm_min" - minutes - </simpara> - </listitem> - <listitem> - <simpara> - "tm_hour" - heure - </simpara> - </listitem> - <listitem> - <simpara> - "tm_mday" - jour du mois - </simpara> - </listitem> - <listitem> - <simpara> - "tm_mon" - mois de l'année - </simpara> - </listitem> - <listitem> - <simpara> - "tm_year" - Année, incompatible an 2000 - </simpara> - </listitem> - <listitem> - <simpara> - "tm_wday" - Jour de la semaine - </simpara> - </listitem> - <listitem> - <simpara> - "tm_yday" - Jour de l'année - </simpara> - </listitem> - <listitem> - <simpara> - "tm_isdst" - Est ce que l'heure d'hiver a pris effet - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.microtime"> - <refnamediv> - <refname>microtime</refname> - <refpurpose> - Retourne le timestamp UNIX actuel avec microsecondes. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>microtime</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>microtime</function> retourne la chaîne "msec sec" - avec sec qui est mesurée en secondes depuis le début - de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec - qui est le nombre de microsecondes de cette heure. Cette fonction - est seulement disponible sur les systèmes d'exploitation qui - supportent la fonction système gettimeofday(). - </para> - <para> - Les deux parties de la chaîne sont exprimées en secondes. - <example> - <title>Exemple avec <function>microtime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>strftime</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.localtime"> + <refnamediv> + <refname>localtime</refname> + <refpurpose>Lit l'heure locale</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>localtime</function></funcdef> + <paramdef>int + <parameter> + <optional>timestamp</optional> + </parameter> + </paramdef> + <paramdef>boolean + <parameter> + <optional>is_associative</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>localtime</function> retourne un tableau identique à + la structure retournée par la fonction C localtime. Le premier + argument <parameter>timestamp</parameter> est un timestamp + UNIX. S'il n'est pas fourni, l'heure courante est utilisée. + Le second argument <parameter>is_associative</parameter>, s'il + est mis à 0 ou ignoré, force <function>localtime</function> + à retourner un tableau à index numérique. S'il est mis à 1, + <function>localtime</function> retourne un tableau associatif, + avec tous les éléments de la structure C, accessible avec les clés + suivantes : + <itemizedlist> + <listitem> + <simpara> + "tm_sec" - secondes + </simpara> + </listitem> + <listitem> + <simpara> + "tm_min" - minutes + </simpara> + </listitem> + <listitem> + <simpara> + "tm_hour" - heure + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mday" - jour du mois + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mon" - mois de l'année + </simpara> + </listitem> + <listitem> + <simpara> + "tm_year" - Année, incompatible an 2000 + </simpara> + </listitem> + <listitem> + <simpara> + "tm_wday" - Jour de la semaine + </simpara> + </listitem> + <listitem> + <simpara> + "tm_yday" - Jour de l'année + </simpara> + </listitem> + <listitem> + <simpara> + "tm_isdst" - Est-ce que l'heure d'hiver a pris effet? + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.microtime"> + <refnamediv> + <refname>microtime</refname> + <refpurpose> + Retourne le timestamp UNIX actuel avec microsecondes. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>microtime</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>microtime</function> retourne la chaîne "msec sec" + avec sec qui est mesurée en secondes depuis le début + de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec + qui est le nombre de microsecondes de cette heure. Cette fonction + est seulement disponible sur les systèmes d'exploitation qui + supportent la fonction système gettimeofday(). + </para> + <para> + Les deux parties de la chaîne sont exprimées en secondes. + <example> + <title>Exemple avec <function>microtime</function></title> + <programlisting role="php"> <?php function getmicrotime(){ list($usec, $sec) = explode(" ",microtime()); - return ((float)$usec + (float)$sec); + return ((float)$usec + (float)$sec); } $time_start = getmicrotime(); for ($i=0; $i < 1000; $i++){ @@ -653,335 +660,338 @@ $time = $time_end - $time_start; echo "Rien fait durant $time secondes"; ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>time</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mktime"> - <refnamediv> - <refname>mktime</refname> - <refpurpose> - Retourne le timestamp UNIX d'une date. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mktime</function></funcdef> - <paramdef>int <parameter>hour</parameter></paramdef> - <paramdef>int <parameter>minute</parameter></paramdef> - <paramdef>int <parameter>second</parameter></paramdef> - <paramdef>int <parameter>month</parameter></paramdef> - <paramdef>int <parameter>day</parameter></paramdef> - <paramdef>int <parameter>year</parameter></paramdef> - <paramdef>int - <parameter><optional>is_dst</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <emphasis>ATTENTION</emphasis> : l'ordre des arguments est - différent de celui de la commande UNIX habituelle mktime(), - et fournit des résultats aléatoires si on oublie cet - ordre. C'est une erreur très commune que de se tromper de sens. - </para> - <para> - <function>mktime</function> retourne un timestamp UNIX - correspondant aux arguments fournis. Ce timestamp est un - entier long, contenant le nombre de secondes entre le début - de l'époque UNIX (1er Janvier 1970) et le temps - spécifié. - </para> - <para> - Les arguments peuvent être omis, de gauche à droite, - et tous les arguments manquants sont utilisés avec la valeur - courante de l'heure et du jour. - </para> - <para> - <parameter>is_dst</parameter> peut être mis à 1 si - l'heure d'hiver est appliquée, 0 si elle ne l'est pas, et -1 - (par défaut) si on ne sait pas. - </para> - <note> - <para> - <parameter>is_dst</parameter> a été ajouté - à partir de la version 3.0.10. - </para> - </note> - <para> - <function>mktime</function> est pratique pour faire des calculs de dates et des - validations, car elle va automatiquement corriger les valeurs invalides. - Par exemple, toutes les lignes suivantes vont retourner la même date : - "Jan-01-1998". - <example> - <title>Exemple <function>mktime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>time</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.mktime"> + <refnamediv> + <refname>mktime</refname> + <refpurpose> + Retourne le timestamp UNIX d'une date. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mktime</function></funcdef> + <paramdef>int <parameter>hour</parameter></paramdef> + <paramdef>int <parameter>minute</parameter></paramdef> + <paramdef>int <parameter>second</parameter></paramdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + <paramdef>int + <parameter><optional>is_dst</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <emphasis>ATTENTION</emphasis> : l'ordre des arguments est + différent de celui de la commande UNIX habituelle mktime(), + et fournit des résultats aléatoires si on oublie cet + ordre. C'est une erreur très commune que de se tromper de sens. + </para> + <para> + <function>mktime</function> retourne un timestamp UNIX + correspondant aux arguments fournis. Ce timestamp est un + entier long, contenant le nombre de secondes entre le début + de l'époque UNIX (1er Janvier 1970) et le temps + spécifié. + </para> + <para> + Les arguments peuvent être omis, de gauche à droite, + et tous les arguments manquants sont utilisés avec la valeur + courante de l'heure et du jour. + </para> + <para> + <parameter>is_dst</parameter> peut être mis à 1 si + l'heure d'hiver est appliquée, 0 si elle ne l'est pas, et -1 + (par défaut) si on ne sait pas. + </para> + <note> + <para> + <parameter>is_dst</parameter> a été ajouté + à partir de la version 3.0.10. + </para> + </note> + <para> + <function>mktime</function> est pratique pour faire des calculs de dates et des + validations, car elle va automatiquement corriger les valeurs invalides. + Par exemple, toutes les lignes suivantes vont retourner la même date : + "Jan-01-1998". + <example> + <title>Exemple <function>mktime</function></title> + <programlisting role="php"> <?php echo date ("M-d-Y", mktime (0,0,0,12,32,1997)); echo date ("M-d-Y", mktime (0,0,0,13,1,1997)); echo date ("M-d-Y", mktime (0,0,0,1,1,1998)); echo date ("M-d-Y", mktime (0,0,0,1,1,98)); ?> - </programlisting> - </example> - <parameter>year</parameter> peut prendre deux ou quatre chiffres, - avec les valeurs entre 0-69 qui correspondent à 2000-2069 et - 70-99 à 1970-1999 (sur les systèmes ooúugrave; - time_t sont sur des entiers 32bit signés, comme cela se - fait le plus souvent de nos jours, <parameter>year</parameter> - est valide dans l'intervalle 1902 et 2037. - </para> - <para> - Le dernier jours d'un mois peut être décrit comme - le jour "0" du mois suivant, et non pas le jour -1. Les deux - exemples suivants vont donner : - "Le dernier jour de Février 2000 est: 29". - <example> - <title>Dernier jour du mois</title> - <programlisting role="php"> + </programlisting> + </example> + <parameter>year</parameter> peut prendre deux ou quatre chiffres, + avec les valeurs entre 0-69 qui correspondent à 2000-2069 et + 70-99 à 1970-1999 (sur les systèmes où + time_t sont sur des entiers 32bit signés, comme cela se + fait le plus souvent de nos jours, <parameter>year</parameter> + est valide dans l'intervalle 1902 et 2037. + </para> + <para> + Le dernier jour d'un mois peut être décrit comme + le jour "0" du mois suivant, et non pas le jour -1. Les deux + exemples suivants vont donner : + "Le dernier jour de Février 2000 est: 29". + <example> + <title>Dernier jour du mois</title> + <programlisting role="php"> <?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Le dernier jour de Février 2000 est: %d", $lastday); $lastday = mktime (0,0,0,4,-31,2000); echo strftime ("Le dernier jour de Février 2000 est: %d", $lastday); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>date</function> et <function>time</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.strftime"> - <refnamediv> - <refname>strftime</refname> - <refpurpose> - Formate une date/heure locale avec les options locales. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>strftime</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter> - <optional>timestamp</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>strftime</function> retourne la date sous la forme - d'une chaîne formatée conformément au format - <parameter>format</parameter>, en utilisant le timestamp - <parameter>timestamp</parameter> donné. Si le - <parameter>timestamp</parameter> est omis, la date actuelle est - utilisée. Les mois et jours de la semaine, et toutes les - chaînes dépendantes de la langue sont fixées - avec la commande <function>setlocale</function>. - </para> - <para> - Les caractères suivant 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 - same as %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> - %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 - newline character - </simpara> - </listitem> - <listitem> - <simpara> - %p - soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction - des valeurs enregistrées en local. - </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> - </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. - </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 - fuseau horaire, ou nom ou abréviation - </simpara> - </listitem> - <listitem> - <simpara> - %% - un caractère `%' littéral - </simpara> - </listitem> - </itemizedlist> - <note> - <para> - Tous les caractères suivants ne sont pas toujours supportés par - toutes les librairies C. Dans ce cas, ils ne seront pas supportés - par PHP non plus. - </para> - </note> - <example> - <title>Exemple <function>strftime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function> et + <function>time</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.strftime"> + <refnamediv> + <refname>strftime</refname> + <refpurpose> + Formate une date/heure locale avec les options locales. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>strftime</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter> + <optional>timestamp</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>strftime</function> retourne la date sous la forme + d'une chaîne formatée conformément au format + <parameter>format</parameter>, en utilisant le timestamp + <parameter>timestamp</parameter> donné. Si le + <parameter>timestamp</parameter> est omis, la date actuelle est + utilisée. Les mois et jours de la semaine, et toutes les + chaînes dépendantes de la langue sont fixées + avec la commande <function>setlocale</function>. + </para> + <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> + %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 - newline character + </simpara> + </listitem> + <listitem> + <simpara> + %p - soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction + des valeurs enregistrées en local. + </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> + </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. + </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 - fuseau horaire, ou nom ou abréviation + </simpara> + </listitem> + <listitem> + <simpara> + %% - un caractère `%' littéral + </simpara> + </listitem> + </itemizedlist> + <note> + <para> + Tous les caractères suivants ne sont pas toujours supportés par + toutes les librairies C. Dans ce cas, ils ne seront pas supportés + par PHP non plus. + </para> + </note> + <example> + <title>Exemple <function>strftime</function></title> + <programlisting role="php"> <?php setlocale ("LC_TIME", "C"); print(strftime("%A en Finlandais est ")); @@ -992,68 +1002,70 @@ setlocale ("LC_TIME", "de"); print(strftime("%A.\n")); ?> - </programlisting> - </example> - Cet exemple ne fonctionnera que si vous avez les configurations respectives - installées sur votre système. - </para> - <para> - Voir aussi <function>setlocale</function> et <function>mktime</function> - et le <ulink url="&spec.strftime;">groupe de spécifications de - strftime()</ulink>. - </para> - </refsect1> - </refentry> - <refentry id="function.time"> - <refnamediv> - <refname>time</refname> - <refpurpose> - Retourne le timestamp UNIX actuel. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>time</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>time</function> retourne la heure courante, mesurée - en secondes depuis le début de l'époque UNIX, (1er - janvier 1970 00:00:00 GMT). - </para> - <para> - Voir aussi <function>date</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.strtotime"> - <refnamediv> - <refname>strtotime</refname> - <refpurpose> - Transforme un texte anglais en timestamp - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>strtotime</function></funcdef> - <paramdef>string <parameter>time</parameter></paramdef> - <paramdef>int - <parameter><optional>now</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>strtotime</function> essaye de lire une date au format - anglais dans la chaîne <parameter>time</parameter>, - et de la transformer en timestamp UNIX. - <example> - <title>Exemple avec <function>strtotime</function></title> - <programlisting role="php"> + </programlisting> + </example> + Cet exemple ne fonctionnera que si vous avez les configurations respectives + installées sur votre système. + </para> + <para> + Voir aussi + <function>setlocale</function>, + <function>mktime</function> et + le <ulink url="&spec.strftime;">groupe de spécifications de strftime()</ulink>. + </para> + </refsect1> + </refentry> + <refentry id="function.time"> + <refnamediv> + <refname>time</refname> + <refpurpose> + Retourne le timestamp UNIX actuel. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>time</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>time</function> retourne l'heure courante, mesurée + en secondes depuis le début de l'époque UNIX, (1er + janvier 1970 00:00:00 GMT). + </para> + <para> + Voir aussi + <function>date</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.strtotime"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose> + Transforme un texte anglais en timestamp + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>strtotime</function></funcdef> + <paramdef>string <parameter>time</parameter></paramdef> + <paramdef>int + <parameter><optional>now</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>strtotime</function> essaye de lire une date au format + anglais dans la chaîne <parameter>time</parameter>, + et de la transformer en timestamp UNIX. + <example> + <title>Exemple avec <function>strtotime</function></title> + <programlisting role="php"> <?php // l'exemple n'est pas traduit, car cela ne fonctionne qu'en anglais echo strtotime("now") . "\n"; @@ -1062,12 +1074,12 @@ echo strtotime("+1 week") . "\n"; echo strtotime("+1 week 2 days 4 hours 2 seconds")."\n"; ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/datetime.xml diff -u phpdoc/fr/functions/datetime.xml:1.19 phpdoc/fr/functions/datetime.xml:1.20 --- phpdoc/fr/functions/datetime.xml:1.19 Mon Apr 23 14:23:28 2001 +++ phpdoc/fr/functions/datetime.xml Mon Jul 2 06:21:40 2001 @@ -1,273 +1,275 @@ - <reference id="ref.datetime"> - <title>Dates et heures</title> - <titleabbrev>Date/heure</titleabbrev> - <refentry id="function.checkdate"> - <refnamediv> - <refname>checkdate</refname> - <refpurpose>Valide une date/heure.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>checkdate</function></funcdef> - <paramdef>int <parameter>month</parameter></paramdef> - <paramdef>int <parameter>day</parameter></paramdef> - <paramdef>int <parameter>year</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>checkdate</function> retourne <literal>TRUE</literal> - si la date - <parameter>day</parameter>/<parameter>month</parameter>/<parameter>year</parameter> - est valide, et sinon <literal>FALSE</literal>. - Notez bien que l'ordre des arguments n'est pas l'ordre français. - La date est considérée comme valide si : - <itemizedlist> - <listitem> - <simpara> - L'année est comprise entre entre 0 et 32767 inclus - </simpara> - </listitem> - <listitem> - <simpara> - Le mois est compris entre 1 et 12 inclus - </simpara> - </listitem> - <listitem> - <simpara> - Le jour est compris dans l'intervalle de date du mois. - Les années bissextiles sont prises en compte. - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.date"> - <refnamediv> - <refname>date</refname> - <refpurpose>Formate une date/heure locale</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>date</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter> - <optional>timestamp</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>date</function> retourne une date sous forme d'une chaîne, au format - donné par la chaîne format. La date est fournie - sous la forme d'un <parameter>timestamp</parameter>. Par défaut, - la date courante est utilisée. - </para> - <para> - Les caractères suivants sont utilisés pour - spécifier le format : - <itemizedlist> - <listitem> - <simpara> - a - "am" (matin) ou "pm" (après-midi) - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" (matin) ou "PM" (après-midi) - </simpara> - </listitem> - <listitem> - <simpara> - B - Heure Internet Swatch - </simpara> - </listitem> - <listitem> - <simpara> - d - Jour du mois, sur deux chiffres (éventuellement avec un zéro) : - "01" à "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - Jour de la semaine, en trois lettres (et en anglais) : par exemple - "Fri" (pour Vendredi) - </simpara> - </listitem> - <listitem> - <simpara> - F - Mois, textuel, version longue; en anglais, i.e. - "January" (pour Janvier) - </simpara> - </listitem> - <listitem> - <simpara> - g - Heure, au format 12h, sans les zéros initiaux - i.e. "1" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - Heure, au format 24h, sans les zéros initiaux - i.e. "0" à "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - Heure, au format 12h, "01" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - heure, au format 24h, "00" à "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - Minutes; "00" à "59" - </simpara> - </listitem> - <listitem> - <simpara> - I (i majuscule) - "1" si l'heure d'hivers est activée, "0" sinon. - </simpara> - </listitem> - <listitem> - <simpara> - j - Jour du mois sans les zéros initiaux: "1" à "31" - </simpara> - </listitem> - <listitem> - <simpara> - l - ('L' minuscule) - Jour de la semaine, textuel, version longue; - en anglais, i.e. "Friday" (pour Vendredi) - </simpara> - </listitem> - <listitem> - <simpara> - L - Booléen pour savoir si l'année est bissextile ("1") ou pas ("0") - </simpara> - </listitem> - <listitem> - <simpara> - m - - Mois; i.e. "01" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - Mois, en trois lettres (et en anglais) : par exemple "Apr" (pour Avril) - </simpara> - </listitem> - <listitem> - <simpara> - n - Mois sans les zéros initiaux; i.e. "1" à "12" - </simpara> - </listitem> - <listitem> - <simpara> - r - Format de date RFC 822; i.e. "Thu, 21 Dec 2000 16:01:07 +0200" - (ajouté en PHP 4.0.4) - </simpara> - </listitem> - <listitem> - <simpara> - s - Secondes; i.e. "00" à "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - Suffixe ordinal d'un nombre, en anglais, sur deux lettres : - i.e. "th", "nd" - </simpara> - </listitem> - <listitem> - <simpara> - t - Nombre de jour dans le mois donné, i.e. "28" à "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - Fuseau horaire de la machine ; i.e. "MET" - </simpara> - </listitem> - <listitem> - <simpara> - U - Secondes depuis une époque - </simpara> - </listitem> - <listitem> - <simpara> - w - Jour de la semaine, numérique, i.e. "0" (Dimanche) to "6" (Samedi) - </simpara> - </listitem> - <listitem> - <simpara> - Y - Année, 4 chiffres; i.e. "1999" - </simpara> - </listitem> - <listitem> - <simpara> - y - Année, 2 chiffres; i.e. "99" - </simpara> - </listitem> - <listitem> - <simpara> - z - Jour de l'année; i.e. "0" à "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - Décalage horaire en secondes (i.e. "-43200" à "43200") - </simpara> - </listitem> - </itemizedlist> - Les caractères non reconnus seront imprimés tels quel. - "Z" retournera toujours "0" lorsqu'il est utilisé avec - <function>gmdate</function>. - <example> - <title>Exemple avec <function>date</function></title> - <programlisting role="php"> +<reference id="ref.datetime"> + <title>Dates et heures</title> + <titleabbrev>Date/heure</titleabbrev> + <refentry id="function.checkdate"> + <refnamediv> + <refname>checkdate</refname> + <refpurpose>Valide une date/heure.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>checkdate</function></funcdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>checkdate</function> retourne <literal>TRUE</literal> + si la date + <parameter>day</parameter>/<parameter>month</parameter>/<parameter>year</parameter> + est valide, et sinon <literal>FALSE</literal>. + Notez bien que l'ordre des arguments n'est pas l'ordre français. + La date est considérée comme valide si : + <itemizedlist> + <listitem> + <simpara> + L'année est comprise entre entre 1 et 32767 inclus. + (pour les versions antérieures à PHP 4.0.3, les années inférieures à + 1 étaient aussi valides). + </simpara> + </listitem> + <listitem> + <simpara> + Le mois est compris entre 1 et 12 inclus + </simpara> + </listitem> + <listitem> + <simpara> + Le jour est compris dans l'intervalle de dates du mois. + Les années bissextiles sont prises en compte. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.date"> + <refnamediv> + <refname>date</refname> + <refpurpose>Formate une date/heure locale</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>date</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter> + <optional>timestamp</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>date</function> retourne une date sous forme d'une chaîne, au format + donné par la chaîne format. La date est fournie + sous la forme d'un <parameter>timestamp</parameter>. Par défaut, + la date courante est utilisée. + </para> + <para> + Les caractères suivants sont utilisés pour + spécifier le format : + <itemizedlist> + <listitem> + <simpara> + a - "am" (matin) ou "pm" (après-midi) + </simpara> + </listitem> + <listitem> + <simpara> + A - "AM" (matin) ou "PM" (après-midi) + </simpara> + </listitem> + <listitem> + <simpara> + B - Heure Internet Swatch + </simpara> + </listitem> + <listitem> + <simpara> + d - Jour du mois, sur deux chiffres (éventuellement avec un zéro) : + "01" à "31" + </simpara> + </listitem> + <listitem> + <simpara> + D - Jour de la semaine, en trois lettres (et en anglais) : par exemple + "Fri" (pour Vendredi) + </simpara> + </listitem> + <listitem> + <simpara> + F - Mois, textuel, version longue; en anglais, i.e. + "January" (pour Janvier) + </simpara> + </listitem> + <listitem> + <simpara> + g - Heure, au format 12h, sans les zéros initiaux + i.e. "1" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + G - Heure, au format 24h, sans les zéros initiaux + i.e. "0" à "23" + </simpara> + </listitem> + <listitem> + <simpara> + h - Heure, au format 12h, "01" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + H - heure, au format 24h, "00" à "23" + </simpara> + </listitem> + <listitem> + <simpara> + i - Minutes; "00" à "59" + </simpara> + </listitem> + <listitem> + <simpara> + I (i majuscule) - "1" si l'heure d'été est activée, "0" si l'heure d'hiver . + </simpara> + </listitem> + <listitem> + <simpara> + j - Jour du mois sans les zéros initiaux: "1" à "31" + </simpara> + </listitem> + <listitem> + <simpara> + l - ('L' minuscule) - Jour de la semaine, textuel, version longue; + en anglais, i.e. "Friday" (pour Vendredi) + </simpara> + </listitem> + <listitem> + <simpara> + L - Booléen pour savoir si l'année est bissextile ("1") ou pas ("0") + </simpara> + </listitem> + <listitem> + <simpara> + m - Mois; i.e. "01" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + M - Mois, en trois lettres (et en anglais) : par exemple "Apr" (pour Avril) + </simpara> + </listitem> + <listitem> + <simpara> + n - Mois sans les zéros initiaux; i.e. "1" à "12" + </simpara> + </listitem> + <listitem> + <simpara> + r - Format de date RFC 822; i.e. "Thu, 21 Dec 2000 16:01:07 +0200" + (ajouté en PHP 4.0.4) + </simpara> + </listitem> + <listitem> + <simpara> + s - Secondes; i.e. "00" à "59" + </simpara> + </listitem> + <listitem> + <simpara> + S - Suffixe ordinal d'un nombre, en anglais, sur deux lettres : + i.e. "th", "nd" + </simpara> + </listitem> + <listitem> + <simpara> + t - Nombre de jours dans le mois donné, i.e. "28" à "31" + </simpara> + </listitem> + <listitem> + <simpara> + T - Fuseau horaire de la machine ; i.e. "MET" + </simpara> + </listitem> + <listitem> + <simpara> + U - Secondes depuis une époque + </simpara> + </listitem> + <listitem> + <simpara> + w - Jour de la semaine, numérique, i.e. "0" (Dimanche) to "6" (Samedi) + </simpara> + </listitem> + <listitem> + <simpara> + Y - Année, 4 chiffres; i.e. "1999" + </simpara> + </listitem> + <listitem> + <simpara> + y - Année, 2 chiffres; i.e. "99" + </simpara> + </listitem> + <listitem> + <simpara> + z - Jour de l'année; i.e. "0" à "365" + </simpara> + </listitem> + <listitem> + <simpara> + Z - Décalage horaire en secondes (i.e. "-43200" à "43200") + </simpara> + </listitem> + </itemizedlist> + Les caractères non reconnus seront imprimés tels quel. + "Z" retournera toujours "0" lorsqu'il est utilisé avec + <function>gmdate</function>. + <example> + <title>Exemple avec <function>date</function></title> + <programlisting role="php"> print (date("l dS of F Y h:i:s A")); print ("July 1, 2000 is on a " . date("l", mktime(0,0,0,7,1,2000))); - </programlisting> - </example> - </para> - <para> - Il est possible d'utiliser <function>date</function> et - <function>mktime</function> ensemble pour génèrer - des dates dans futur ou dans passé. - <example> - <title> - Exemples avec <function>date</function> et <function>mktime</function> - </title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Il est possible d'utiliser <function>date</function> et + <function>mktime</function> ensemble pour générer + des dates dans le futur ou dans le passé. + <example> + <title> + Exemples avec <function>date</function> et <function>mktime</function> + </title> + <programlisting role="php"> <?php $tomorrow = mktime(0,0,0,date("m") ,date("d") + 1,date("Y") ); $lastmonth = mktime(0,0,0,date("m")-1,date("d") ,date("Y") ); $nextyear = mktime(0,0,0,date("m"), date("d") ,date("Y") + 1); ?> - </programlisting> - </example> - </para> - <para> - Voici maintenant quelques exemples de formattages avec - <function>date</function>. Notez que vous devriez échapper tous - les autres caractères, car s'ils ont une signification - spéciale, ils risquent de produire des effets secondaires - indésirables. Notez aussi que les versions futures de PHP - peuvent attribuer une signification à des lettres qui sont - actuellement inertes. Lorsque vous échappez les caractères, - pensez à utiiser des guillemets simples, pour que les - séquences <literal>\n</literal> ne deviennent pas des - nouvelles lignes. - <example> - <title>Formattage avec <function>date</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voici maintenant quelques exemples de formatages avec + <function>date</function>. Notez que vous devriez échapper tous + les autres caractères, car s'ils ont une signification + spéciale, ils risquent de produire des effets secondaires + indésirables. Notez aussi que les versions futures de PHP + peuvent attribuer une signification à des lettres qui sont + actuellement inertes. Lorsque vous échappez les caractères, + pensez à utiiser des guillemets simples, pour que les + séquences <literal>\n</literal> ne deviennent pas des + nouvelles lignes. + <example> + <title>Formatage avec <function>date</function></title> + <programlisting role="php"> <?php /* Aujourd'hui, le 12 Mars 2001, 10:16:18 pm */ $aujourdhui = date("F j, Y, g:i a"); // March 12, 2001, 10:16 pm @@ -283,93 +285,95 @@ $aujourdhui = date("d/m/y"); // 12/03/01 $aujourdhui = date("d/m/Y"); // 12/03/2001 ?> - </programlisting> - </example> - </para> - <para> - Pour formater des dates dans d'autres langues, utilisez les fonctions - <function>setlocale</function> et <function>strftime</function>. - </para> - <para> - Voir aussi <function>gmdate</function> et <function>mktime</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.getdate"> - <refnamediv> - <refname>getdate</refname> - <refpurpose>Retourne la date/heure</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>getdate</function></funcdef> - <paramdef>int - <parameter><optional>timestamp</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>getdate</function> retourne un tableau associatif contenant les informations - de date et heure du timestamp <parameter>timestamp</parameter> (lorsqu'il est fourni), - avec les champs suivants : - <itemizedlist> - <listitem> - <simpara> - "seconds" - secondes - </simpara> - </listitem> - <listitem> - <simpara> - "minutes" - minutes - </simpara> - </listitem> - <listitem> - <simpara> - "hours" - heures - </simpara> - </listitem> - <listitem> - <simpara> - "mday" - jour du mois - </simpara> - </listitem> - <listitem> - <simpara> - "wday" - jour de la semaine, numérique. 0: dimanche jusqu'à 6: samedi - </simpara> - </listitem> - <listitem> - <simpara> - "mon" - mois, numérique - </simpara> - </listitem> - <listitem> - <simpara> - "year" - année, numérique - </simpara> - </listitem> - <listitem> - <simpara> - "yday" - jour de l'année, numérique; i.e. "299" - </simpara> - </listitem> - <listitem> - <simpara> - "weekday" - jour de la semaine, texte complet (en anglais); i.e. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - "month" - mois, texte complet (en anglais); i.e. "January" - </simpara> - </listitem> - </itemizedlist> - </para> - <example> - <title>Exemple avec <function>getdate</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Pour formater des dates dans d'autres langues, utilisez les fonctions + <function>setlocale</function> et <function>strftime</function>. + </para> + <para> + Voir aussi + <function>gmdate</function> et + <function>mktime</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.getdate"> + <refnamediv> + <refname>getdate</refname> + <refpurpose>Retourne la date/heure</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>getdate</function></funcdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>getdate</function> retourne un tableau associatif contenant les informations + de date et d'heure du timestamp <parameter>timestamp</parameter> (lorsqu'il est fourni), + avec les champs suivants : + <itemizedlist> + <listitem> + <simpara> + "seconds" - secondes + </simpara> + </listitem> + <listitem> + <simpara> + "minutes" - minutes + </simpara> + </listitem> + <listitem> + <simpara> + "hours" - heures + </simpara> + </listitem> + <listitem> + <simpara> + "mday" - jour du mois + </simpara> + </listitem> + <listitem> + <simpara> + "wday" - jour de la semaine, numérique. 0: dimanche jusqu'à 6: samedi + </simpara> + </listitem> + <listitem> + <simpara> + "mon" - mois, numérique + </simpara> + </listitem> + <listitem> + <simpara> + "year" - année, numérique + </simpara> + </listitem> + <listitem> + <simpara> + "yday" - jour de l'année, numérique; i.e. "299" + </simpara> + </listitem> + <listitem> + <simpara> + "weekday" - jour de la semaine, texte complet (en anglais); i.e. "Friday" + </simpara> + </listitem> + <listitem> + <simpara> + "month" - mois, texte complet (en anglais); i.e. "January" + </simpara> + </listitem> + </itemizedlist> + </para> + <example> + <title>Exemple avec <function>getdate</function></title> + <programlisting role="php"> <?php $aujourdhui = getdate(); $mois = $aujourdhui['month']; @@ -377,273 +381,276 @@ $annee = $aujourdhui['year']; echo "$mjour/$mois/$annee"; ?> - </programlisting> - </example> - </refsect1> - </refentry> - <refentry id="function.gettimeofday"> - <refnamediv> - <refname>gettimeofday</refname> - <refpurpose>Retourne l'heure actuelle </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>gettimeofday</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>gettimeofday</function> est une interface vers gettimeofday(2). Elle - retourne un tableau associatif qui contient les informations retournées - par le système : - <itemizedlist> - <listitem> - <simpara> - "sec" - secondes - </simpara> - </listitem> - <listitem> - <simpara> - "usec" - microsecondes - </simpara> - </listitem> - <listitem> - <simpara> - "minuteswest" - minutes de décalage par rapport à Greenwich, - vers l'Ouest. - </simpara> - </listitem> - <listitem> - <simpara> - "dsttime" - type de correction dst - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.gmdate"> - <refnamediv> - <refname>gmdate</refname> - <refpurpose>Formate une date/heure GMT/CUT.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>gmdate</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter><optional>timestamp</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>gmdate</function> est identique à la fonction <function>date</function>, - hormis le fait que le temps retourné est GMT (Greenwich Mean Time) Par exemple, - en Finlande (GMT +0200), la première ligne ci-dessous affiche - "Jan 01 1998 00:00:00", tandis que la seconde "Dec 31 1997 22:00:00". - <example> - <title>Exemple avec <function>gmdate</function></title> - <programlisting role="php"> + </programlisting> + </example> + </refsect1> + </refentry> + <refentry id="function.gettimeofday"> + <refnamediv> + <refname>gettimeofday</refname> + <refpurpose>Retourne l'heure actuelle </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>gettimeofday</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gettimeofday</function> est une interface vers gettimeofday(2). Elle + retourne un tableau associatif qui contient les informations retournées + par le système : + <itemizedlist> + <listitem> + <simpara> + "sec" - secondes + </simpara> + </listitem> + <listitem> + <simpara> + "usec" - microsecondes + </simpara> + </listitem> + <listitem> + <simpara> + "minuteswest" - minutes de décalage par rapport à Greenwich, + vers l'Ouest. + </simpara> + </listitem> + <listitem> + <simpara> + "dsttime" - type de correction dst + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.gmdate"> + <refnamediv> + <refname>gmdate</refname> + <refpurpose>Formate une date/heure GMT/CUT.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gmdate</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gmdate</function> est identique à la fonction <function>date</function>, + hormis le fait que le temps retourné est GMT (Greenwich Mean Time) Par exemple, + en Finlande (GMT +0200), la première ligne ci-dessous affiche + "Jan 01 1998 00:00:00", tandis que la seconde "Dec 31 1997 22:00:00". + <example> + <title>Exemple avec <function>gmdate</function></title> + <programlisting role="php"> <?php echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>date</function>, <function>mktime</function>, - et <function>gmmktime</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.gmmktime"> - <refnamediv> - <refname>gmmktime</refname> - <refpurpose>Retourne le timestamp UNIX d'une date GMT.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>gmmktime</function></funcdef> - <paramdef>int <parameter>hour</parameter></paramdef> - <paramdef>int <parameter>minute</parameter></paramdef> - <paramdef>int <parameter>second</parameter></paramdef> - <paramdef>int <parameter>month</parameter></paramdef> - <paramdef>int <parameter>day</parameter></paramdef> - <paramdef>int <parameter>year</parameter></paramdef> - <paramdef>int - <parameter><optional>is_dst</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Identique à <function>mktime</function> hormis le fait que - les paramètres passés sont GMT. - </para> - </refsect1> - </refentry> - <refentry id="function.gmstrftime"> - <refnamediv> - <refname>gmstrftime</refname> - <refpurpose> - Formate une date/heure GMT/CUT en fonction des paramétrages locaux. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>gmstrftime</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter><optional>timestamp</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>gmstrftime</function> se comporte exactement comme - <function>strftime</function> hormis le fait l'heure utilisée - est celle de Greenwich (Greenwich Mean Time (GMT)). Par exemple, dans - la zone Eastern Standard Time (est des USA) (GMT -0500), la - première ligne de l'exemple ci dessous affiche - "Dec 31 1998 20:00:00", tandis que la seconde affiche "Jan 01 1999 01:00:00". - <example> - <title>Exemple avec <function>gmstrftime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function>, + <function>mktime</function> et + <function>gmmktime</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.gmmktime"> + <refnamediv> + <refname>gmmktime</refname> + <refpurpose>Retourne le timestamp UNIX d'une date GMT.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>gmmktime</function></funcdef> + <paramdef>int <parameter>hour</parameter></paramdef> + <paramdef>int <parameter>minute</parameter></paramdef> + <paramdef>int <parameter>second</parameter></paramdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + <paramdef>int + <parameter><optional>is_dst</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Identique à <function>mktime</function> hormis le fait que + les paramètres passés sont GMT. + </para> + </refsect1> + </refentry> + <refentry id="function.gmstrftime"> + <refnamediv> + <refname>gmstrftime</refname> + <refpurpose> + Formate une date/heure GMT/CUT en fonction des paramétrages locaux. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>gmstrftime</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>gmstrftime</function> se comporte exactement comme + <function>strftime</function> hormis le fait que l'heure utilisée + est celle de Greenwich (Greenwich Mean Time (GMT)). Par exemple, dans + la zone Eastern Standard Time (est des USA) (GMT -0500), la + première ligne de l'exemple ci-dessous affiche + "Dec 31 1998 20:00:00", tandis que la seconde affiche "Jan 01 1999 01:00:00". + <example> + <title>Exemple avec <function>gmstrftime</function></title> + <programlisting role="php"> <?php setlocale ('LC_TIME', 'en_US'); echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>strftime</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.localtime"> - <refnamediv> - <refname>localtime</refname> - <refpurpose>Lit l'heure locale</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>localtime</function></funcdef> - <paramdef>int - <parameter> - <optional>timestamp</optional> - </parameter> - </paramdef> - <paramdef>bool - <parameter> - <optional>is_associative</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>localtime</function> retourne un tableau identique à - la structure retournée par la fonction C localtime. Le premier - argument <parameter>timestamp</parameter> est un timestamp - UNIX. S'il n'est pas fourni, l'heure courante est utilisée. - Le second argument <parameter>is_associative</parameter>, s'il - est mis à 0 ou ignoré, force <function>localtime</function> - a retourner un tableau à index numérique. S'il est mis à 1, - <function>localtime</function> retourne un tableau associatif, - avec tous les éléments de la structure C, accessible avec les clés - suivantes : - <itemizedlist> - <listitem> - <simpara> - "tm_sec" - secondes - </simpara> - </listitem> - <listitem> - <simpara> - "tm_min" - minutes - </simpara> - </listitem> - <listitem> - <simpara> - "tm_hour" - heure - </simpara> - </listitem> - <listitem> - <simpara> - "tm_mday" - jour du mois - </simpara> - </listitem> - <listitem> - <simpara> - "tm_mon" - mois de l'année - </simpara> - </listitem> - <listitem> - <simpara> - "tm_year" - Année, incompatible an 2000 - </simpara> - </listitem> - <listitem> - <simpara> - "tm_wday" - Jour de la semaine - </simpara> - </listitem> - <listitem> - <simpara> - "tm_yday" - Jour de l'année - </simpara> - </listitem> - <listitem> - <simpara> - "tm_isdst" - Est ce que l'heure d'hiver a pris effet - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.microtime"> - <refnamediv> - <refname>microtime</refname> - <refpurpose> - Retourne le timestamp UNIX actuel avec microsecondes. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>microtime</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>microtime</function> retourne la chaîne "msec sec" - avec sec qui est mesurée en secondes depuis le début - de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec - qui est le nombre de microsecondes de cette heure. Cette fonction - est seulement disponible sur les systèmes d'exploitation qui - supportent la fonction système gettimeofday(). - </para> - <para> - Les deux parties de la chaîne sont exprimées en secondes. - <example> - <title>Exemple avec <function>microtime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>strftime</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.localtime"> + <refnamediv> + <refname>localtime</refname> + <refpurpose>Lit l'heure locale</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>localtime</function></funcdef> + <paramdef>int + <parameter> + <optional>timestamp</optional> + </parameter> + </paramdef> + <paramdef>boolean + <parameter> + <optional>is_associative</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>localtime</function> retourne un tableau identique à + la structure retournée par la fonction C localtime. Le premier + argument <parameter>timestamp</parameter> est un timestamp + UNIX. S'il n'est pas fourni, l'heure courante est utilisée. + Le second argument <parameter>is_associative</parameter>, s'il + est mis à 0 ou ignoré, force <function>localtime</function> + à retourner un tableau à index numérique. S'il est mis à 1, + <function>localtime</function> retourne un tableau associatif, + avec tous les éléments de la structure C, accessible avec les clés + suivantes : + <itemizedlist> + <listitem> + <simpara> + "tm_sec" - secondes + </simpara> + </listitem> + <listitem> + <simpara> + "tm_min" - minutes + </simpara> + </listitem> + <listitem> + <simpara> + "tm_hour" - heure + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mday" - jour du mois + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mon" - mois de l'année + </simpara> + </listitem> + <listitem> + <simpara> + "tm_year" - Année, incompatible an 2000 + </simpara> + </listitem> + <listitem> + <simpara> + "tm_wday" - Jour de la semaine + </simpara> + </listitem> + <listitem> + <simpara> + "tm_yday" - Jour de l'année + </simpara> + </listitem> + <listitem> + <simpara> + "tm_isdst" - Est-ce que l'heure d'hiver a pris effet? + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.microtime"> + <refnamediv> + <refname>microtime</refname> + <refpurpose> + Retourne le timestamp UNIX actuel avec microsecondes. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>microtime</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>microtime</function> retourne la chaîne "msec sec" + avec sec qui est mesurée en secondes depuis le début + de l'époque UNIX, (1er janvier 1970 00:00:00 GMT), et msec + qui est le nombre de microsecondes de cette heure. Cette fonction + est seulement disponible sur les systèmes d'exploitation qui + supportent la fonction système gettimeofday(). + </para> + <para> + Les deux parties de la chaîne sont exprimées en secondes. + <example> + <title>Exemple avec <function>microtime</function></title> + <programlisting role="php"> <?php function getmicrotime(){ list($usec, $sec) = explode(" ",microtime()); - return ((float)$usec + (float)$sec); + return ((float)$usec + (float)$sec); } $time_start = getmicrotime(); for ($i=0; $i < 1000; $i++){ @@ -653,335 +660,338 @@ $time = $time_end - $time_start; echo "Rien fait durant $time secondes"; ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>time</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mktime"> - <refnamediv> - <refname>mktime</refname> - <refpurpose> - Retourne le timestamp UNIX d'une date. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mktime</function></funcdef> - <paramdef>int <parameter>hour</parameter></paramdef> - <paramdef>int <parameter>minute</parameter></paramdef> - <paramdef>int <parameter>second</parameter></paramdef> - <paramdef>int <parameter>month</parameter></paramdef> - <paramdef>int <parameter>day</parameter></paramdef> - <paramdef>int <parameter>year</parameter></paramdef> - <paramdef>int - <parameter><optional>is_dst</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <emphasis>ATTENTION</emphasis> : l'ordre des arguments est - différent de celui de la commande UNIX habituelle mktime(), - et fournit des résultats aléatoires si on oublie cet - ordre. C'est une erreur très commune que de se tromper de sens. - </para> - <para> - <function>mktime</function> retourne un timestamp UNIX - correspondant aux arguments fournis. Ce timestamp est un - entier long, contenant le nombre de secondes entre le début - de l'époque UNIX (1er Janvier 1970) et le temps - spécifié. - </para> - <para> - Les arguments peuvent être omis, de gauche à droite, - et tous les arguments manquants sont utilisés avec la valeur - courante de l'heure et du jour. - </para> - <para> - <parameter>is_dst</parameter> peut être mis à 1 si - l'heure d'hiver est appliquée, 0 si elle ne l'est pas, et -1 - (par défaut) si on ne sait pas. - </para> - <note> - <para> - <parameter>is_dst</parameter> a été ajouté - à partir de la version 3.0.10. - </para> - </note> - <para> - <function>mktime</function> est pratique pour faire des calculs de dates et des - validations, car elle va automatiquement corriger les valeurs invalides. - Par exemple, toutes les lignes suivantes vont retourner la même date : - "Jan-01-1998". - <example> - <title>Exemple <function>mktime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>time</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.mktime"> + <refnamediv> + <refname>mktime</refname> + <refpurpose> + Retourne le timestamp UNIX d'une date. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mktime</function></funcdef> + <paramdef>int <parameter>hour</parameter></paramdef> + <paramdef>int <parameter>minute</parameter></paramdef> + <paramdef>int <parameter>second</parameter></paramdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + <paramdef>int + <parameter><optional>is_dst</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <emphasis>ATTENTION</emphasis> : l'ordre des arguments est + différent de celui de la commande UNIX habituelle mktime(), + et fournit des résultats aléatoires si on oublie cet + ordre. C'est une erreur très commune que de se tromper de sens. + </para> + <para> + <function>mktime</function> retourne un timestamp UNIX + correspondant aux arguments fournis. Ce timestamp est un + entier long, contenant le nombre de secondes entre le début + de l'époque UNIX (1er Janvier 1970) et le temps + spécifié. + </para> + <para> + Les arguments peuvent être omis, de gauche à droite, + et tous les arguments manquants sont utilisés avec la valeur + courante de l'heure et du jour. + </para> + <para> + <parameter>is_dst</parameter> peut être mis à 1 si + l'heure d'hiver est appliquée, 0 si elle ne l'est pas, et -1 + (par défaut) si on ne sait pas. + </para> + <note> + <para> + <parameter>is_dst</parameter> a été ajouté + à partir de la version 3.0.10. + </para> + </note> + <para> + <function>mktime</function> est pratique pour faire des calculs de dates et des + validations, car elle va automatiquement corriger les valeurs invalides. + Par exemple, toutes les lignes suivantes vont retourner la même date : + "Jan-01-1998". + <example> + <title>Exemple <function>mktime</function></title> + <programlisting role="php"> <?php echo date ("M-d-Y", mktime (0,0,0,12,32,1997)); echo date ("M-d-Y", mktime (0,0,0,13,1,1997)); echo date ("M-d-Y", mktime (0,0,0,1,1,1998)); echo date ("M-d-Y", mktime (0,0,0,1,1,98)); ?> - </programlisting> - </example> - <parameter>year</parameter> peut prendre deux ou quatre chiffres, - avec les valeurs entre 0-69 qui correspondent à 2000-2069 et - 70-99 à 1970-1999 (sur les systèmes ooúugrave; - time_t sont sur des entiers 32bit signés, comme cela se - fait le plus souvent de nos jours, <parameter>year</parameter> - est valide dans l'intervalle 1902 et 2037. - </para> - <para> - Le dernier jours d'un mois peut être décrit comme - le jour "0" du mois suivant, et non pas le jour -1. Les deux - exemples suivants vont donner : - "Le dernier jour de Février 2000 est: 29". - <example> - <title>Dernier jour du mois</title> - <programlisting role="php"> + </programlisting> + </example> + <parameter>year</parameter> peut prendre deux ou quatre chiffres, + avec les valeurs entre 0-69 qui correspondent à 2000-2069 et + 70-99 à 1970-1999 (sur les systèmes où + time_t sont sur des entiers 32bit signés, comme cela se + fait le plus souvent de nos jours, <parameter>year</parameter> + est valide dans l'intervalle 1902 et 2037. + </para> + <para> + Le dernier jour d'un mois peut être décrit comme + le jour "0" du mois suivant, et non pas le jour -1. Les deux + exemples suivants vont donner : + "Le dernier jour de Février 2000 est: 29". + <example> + <title>Dernier jour du mois</title> + <programlisting role="php"> <?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Le dernier jour de Février 2000 est: %d", $lastday); $lastday = mktime (0,0,0,4,-31,2000); echo strftime ("Le dernier jour de Février 2000 est: %d", $lastday); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>date</function> et <function>time</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.strftime"> - <refnamediv> - <refname>strftime</refname> - <refpurpose> - Formate une date/heure locale avec les options locales. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>strftime</function></funcdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>int - <parameter> - <optional>timestamp</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>strftime</function> retourne la date sous la forme - d'une chaîne formatée conformément au format - <parameter>format</parameter>, en utilisant le timestamp - <parameter>timestamp</parameter> donné. Si le - <parameter>timestamp</parameter> est omis, la date actuelle est - utilisée. Les mois et jours de la semaine, et toutes les - chaînes dépendantes de la langue sont fixées - avec la commande <function>setlocale</function>. - </para> - <para> - Les caractères suivant 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 - same as %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> - %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 - newline character - </simpara> - </listitem> - <listitem> - <simpara> - %p - soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction - des valeurs enregistrées en local. - </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> - </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. - </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 - fuseau horaire, ou nom ou abréviation - </simpara> - </listitem> - <listitem> - <simpara> - %% - un caractère `%' littéral - </simpara> - </listitem> - </itemizedlist> - <note> - <para> - Tous les caractères suivants ne sont pas toujours supportés par - toutes les librairies C. Dans ce cas, ils ne seront pas supportés - par PHP non plus. - </para> - </note> - <example> - <title>Exemple <function>strftime</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>date</function> et + <function>time</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.strftime"> + <refnamediv> + <refname>strftime</refname> + <refpurpose> + Formate une date/heure locale avec les options locales. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>strftime</function></funcdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>int + <parameter> + <optional>timestamp</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>strftime</function> retourne la date sous la forme + d'une chaîne formatée conformément au format + <parameter>format</parameter>, en utilisant le timestamp + <parameter>timestamp</parameter> donné. Si le + <parameter>timestamp</parameter> est omis, la date actuelle est + utilisée. Les mois et jours de la semaine, et toutes les + chaînes dépendantes de la langue sont fixées + avec la commande <function>setlocale</function>. + </para> + <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> + %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 - newline character + </simpara> + </listitem> + <listitem> + <simpara> + %p - soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction + des valeurs enregistrées en local. + </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> + </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. + </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 - fuseau horaire, ou nom ou abréviation + </simpara> + </listitem> + <listitem> + <simpara> + %% - un caractère `%' littéral + </simpara> + </listitem> + </itemizedlist> + <note> + <para> + Tous les caractères suivants ne sont pas toujours supportés par + toutes les librairies C. Dans ce cas, ils ne seront pas supportés + par PHP non plus. + </para> + </note> + <example> + <title>Exemple <function>strftime</function></title> + <programlisting role="php"> <?php setlocale ("LC_TIME", "C"); print(strftime("%A en Finlandais est ")); @@ -992,68 +1002,70 @@ setlocale ("LC_TIME", "de"); print(strftime("%A.\n")); ?> - </programlisting> - </example> - Cet exemple ne fonctionnera que si vous avez les configurations respectives - installées sur votre système. - </para> - <para> - Voir aussi <function>setlocale</function> et <function>mktime</function> - et le <ulink url="&spec.strftime;">groupe de spécifications de - strftime()</ulink>. - </para> - </refsect1> - </refentry> - <refentry id="function.time"> - <refnamediv> - <refname>time</refname> - <refpurpose> - Retourne le timestamp UNIX actuel. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>time</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>time</function> retourne la heure courante, mesurée - en secondes depuis le début de l'époque UNIX, (1er - janvier 1970 00:00:00 GMT). - </para> - <para> - Voir aussi <function>date</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.strtotime"> - <refnamediv> - <refname>strtotime</refname> - <refpurpose> - Transforme un texte anglais en timestamp - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>strtotime</function></funcdef> - <paramdef>string <parameter>time</parameter></paramdef> - <paramdef>int - <parameter><optional>now</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>strtotime</function> essaye de lire une date au format - anglais dans la chaîne <parameter>time</parameter>, - et de la transformer en timestamp UNIX. - <example> - <title>Exemple avec <function>strtotime</function></title> - <programlisting role="php"> + </programlisting> + </example> + Cet exemple ne fonctionnera que si vous avez les configurations respectives + installées sur votre système. + </para> + <para> + Voir aussi + <function>setlocale</function>, + <function>mktime</function> et + le <ulink url="&spec.strftime;">groupe de spécifications de strftime()</ulink>. + </para> + </refsect1> + </refentry> + <refentry id="function.time"> + <refnamediv> + <refname>time</refname> + <refpurpose> + Retourne le timestamp UNIX actuel. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>time</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>time</function> retourne l'heure courante, mesurée + en secondes depuis le début de l'époque UNIX, (1er + janvier 1970 00:00:00 GMT). + </para> + <para> + Voir aussi + <function>date</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.strtotime"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose> + Transforme un texte anglais en timestamp + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>strtotime</function></funcdef> + <paramdef>string <parameter>time</parameter></paramdef> + <paramdef>int + <parameter><optional>now</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>strtotime</function> essaye de lire une date au format + anglais dans la chaîne <parameter>time</parameter>, + et de la transformer en timestamp UNIX. + <example> + <title>Exemple avec <function>strtotime</function></title> + <programlisting role="php"> <?php // l'exemple n'est pas traduit, car cela ne fonctionne qu'en anglais echo strtotime("now") . "\n"; @@ -1062,12 +1074,12 @@ echo strtotime("+1 week") . "\n"; echo strtotime("+1 week 2 days 4 hours 2 seconds")."\n"; ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml