mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-29 04:12:21 +02:00
26813bc23d
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@171884 c90b9560-bf6c-de11-be94-00142212c4b1
357 lines
11 KiB
XML
357 lines
11 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision: 1.16 $ -->
|
|
<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready -->
|
|
<refentry id="function.strftime">
|
|
<refnamediv>
|
|
<refname>strftime</refname>
|
|
<refpurpose>
|
|
Formate une date/heure locale avec les options locales
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<type>string</type><methodname>strftime</methodname>
|
|
<methodparam><type>string</type><parameter>format</parameter></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<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>
|
|
<literal>%a</literal> : nom abrégé du jour de la semaine (local).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%A</literal> : nom complet du jour de la semaine (local).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%b</literal> : nom abrégé du mois (local).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%B</literal> : nom complet du mois (local).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%c</literal> : représentation préférée pour
|
|
les dates et heures, en local.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%C</literal> : numéro de siècle (l'année, divisée par 100
|
|
et arrondie entre 00 et 99)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%d</literal> : jour du mois en numérique (intervalle 01 à 31)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%D</literal> : identique à %m/%d/%y
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%e</literal> : numéro du jour du mois. Les chiffres sont précédés
|
|
d'un espace (de ' 1' à '31')
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%g</literal> : identique à %G, sur 2 chiffres.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%G</literal> : L'année sur 4 chiffres correspondant au numéro de semaine (voir %V).
|
|
Même format et valeur que %Y, excepté que si le numéro de la semaine
|
|
appartient à l'année précédente ou suivante, l'année courante sera utilisé à la place.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%h</literal> : identique à %b
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%H</literal> : heure de la journée en numérique, et sur 24-heures
|
|
(intervalle de 00 à 23)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%I</literal> : heure de la journée en numérique, et sur 12- heures
|
|
(intervalle 01 à 12)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%j</literal> : jour de l'année, en numérique (intervalle 001 à 366)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%m</literal> : mois en numérique (intervalle 1 à 12)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%M</literal> : minute en numérique
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%n</literal> : newline character
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%p</literal> : soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction
|
|
des valeurs enregistrées en local.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%r</literal> : l'heure au format a.m. et p.m.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%R</literal> : l'heure au format 24h
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%S</literal> : secondes en numérique
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%t</literal> : tabulation
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%T</literal> : l'heure actuelle (égal à %H:%M:%S)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%u</literal> : le numéro de jour dans la semaine, de 1 à 7. (1 représente
|
|
Lundi)
|
|
</simpara>
|
|
<warning>
|
|
<simpara>
|
|
Les systèmes Sun Solaris semblent commencer le Dimanche à 1 malgré
|
|
le fait que le standart ISO 9889:1999 (actuellement le standart C) spécifie
|
|
clairement le début de la semaine à Lundi.
|
|
</simpara>
|
|
</warning>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%U</literal> : 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>
|
|
<literal>%V</literal> : le numéro de semaine comme défini dans l'ISO 8601:1988,
|
|
sous forme décimale, de 01 à 53. La semaine 1 est la première
|
|
semaine qui a plus de 4 jours dans l'année courante, et dont
|
|
Lundi est le premier jour. (Utilisez %G ou %g pour les éléments de l'année
|
|
qui correspondent au numéro de la semaine pour le timestamp donné.)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%W</literal> : 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>
|
|
<literal>%w</literal> : jour de la semaine, numérique, avec Dimanche = 0
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%x</literal> : format préféré de représentation de la date sans l'heure
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%X</literal> : format préféré de représentation de l'heure sans la date
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%y</literal> : l'année, numérique, sur deux chiffres (de 00 à 99)
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%Y</literal> : l'année, numérique, sur quatre chiffres
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%Z ou %z</literal> : fuseau horaire, ou nom ou abréviation
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<literal>%%</literal> : un caractère `%' littéral
|
|
</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<note>
|
|
<para>
|
|
Tous les caractères suivants ne sont pas toujours supportés par
|
|
toutes les bibliothèques C. Dans ce cas, ils ne seront pas supportés
|
|
par &php; non plus. De plus, toutes les plates-formes ne supportent pas
|
|
les timestamps négatifs, et vos dates pourraient être limitées par le
|
|
début de l'époque Unix. Cela signifie que
|
|
%e, %T, %R et %D (et peut être d'autres) et les dates antérieures au
|
|
<literal>1er Janvier 1970</literal> ne fonctionneront pas sous Windows,
|
|
sur certaines distributions de Linux, et sur certains systèmes d'exploitation.
|
|
Pour Windows, une liste complète des options de conversion est disponible
|
|
sur le <ulink url="&url.strftime.win32;">site de <acronym>MSDN</acronym></ulink>.
|
|
</para>
|
|
</note>
|
|
<example>
|
|
<title>Exemple avec <function>strftime</function></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
setlocale(LC_TIME, "C");
|
|
echo strftime("%A en Finlandais est ");
|
|
setlocale(LC_TIME, "fi");
|
|
echo strftime("%A, en Français ");
|
|
setlocale(LC_TIME, "fr");
|
|
echo strftime("%A et en Allemand ");
|
|
setlocale(LC_TIME, "de");
|
|
echo strftime("%A.\n");
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
Cet exemple ne fonctionnera que si vous avez les locales respectives
|
|
installées sur votre système.
|
|
<note>
|
|
<simpara>
|
|
%G et %V, qui sont basées sur la semaine ISO 8601:1988, peut
|
|
conduire à des résultat inattendus (bien que corrects) si le
|
|
système de numérotation n'est pas connu. Voyez l'exemple
|
|
%V ci-dessus et l'exemple ci-dessous.
|
|
</simpara>
|
|
</note>
|
|
<example>
|
|
<title>Exemple au format de date ISO 8601:1988</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
/* December 2002 / January 2003
|
|
ISOWk M Tu W Thu F Sa Su
|
|
----- ----------------------------
|
|
51 16 17 18 19 20 21 22
|
|
52 23 24 25 26 27 28 29
|
|
1 30 31 1 2 3 4 5
|
|
2 6 7 8 9 10 11 12
|
|
3 13 14 15 16 17 18 19 */
|
|
|
|
// Affiche : 12/28/2002 - %V,%G,%Y = 52,2002,2002
|
|
echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n";
|
|
|
|
// Affiche : 12/30/2002 - %V,%G,%Y = 1,2003,2002
|
|
echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n";
|
|
|
|
// Affiche : 1/3/2003 - %V,%G,%Y = 1,2003,2003
|
|
echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";
|
|
|
|
// Affiche : 1/10/2003 - %V,%G,%Y = 2,2003,2003
|
|
echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
|
|
|
|
|
|
|
|
/* December 2004 / January 2005
|
|
ISOWk M Tu W Thu F Sa Su
|
|
----- ----------------------------
|
|
51 13 14 15 16 17 18 19
|
|
52 20 21 22 23 24 25 26
|
|
53 27 28 29 30 31 1 2
|
|
1 3 4 5 6 7 8 9
|
|
2 10 11 12 13 14 15 16 */
|
|
|
|
// Affiche : 12/23/2004 - %V,%G,%Y = 52,2004,2004
|
|
echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
|
|
|
|
// Affiche : 12/31/2004 - %V,%G,%Y = 53,2004,2004
|
|
echo "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";
|
|
|
|
// Affiche : 1/2/2005 - %V,%G,%Y = 53,2004,2005
|
|
echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";
|
|
|
|
// Affiche : 1/3/2005 - %V,%G,%Y = 1,2005,2005
|
|
echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";
|
|
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<para>
|
|
Voir aussi
|
|
<function>setlocale</function>,
|
|
<function>mktime</function>,
|
|
<function>strptime</function> et
|
|
le <ulink url="&spec.strftime;">groupe de spécifications de <function>strftime</function></ulink>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|