cvs: phpdoc-fr /reference/datetime/functions date-default-timezone-get.xml date-default-timezone-set.xml date-format.xml date-isodate-set.xml
date-modify.xml date-offset-get.xml date-time-set.xml date-timezone-get.xml date-timezone-set.xml date.xml localtime.xml mktime.xml strftime.xml
timezone-identifiers-list.xml timezone-name-get.xml timezone-offset-get.xml timezone-transitions-get.xml /reference/dom/domdocument importnode.xml
registernodeclass.xml

From: Date: Sun, 07 Dec 2008 20:13:55 +0000
Subject: cvs: phpdoc-fr /reference/datetime/functions date-default-timezone-get.xml date-default-timezone-set.xml date-format.xml date-isodate-set.xml
date-modify.xml date-offset-get.xml date-time-set.xml date-timezone-get.xml date-timezone-set.xml date.xml localtime.xml mktime.xml strftime.xml
timezone-identifiers-list.xml timezone-name-get.xml timezone-offset-get.xml timezone-transitions-get.xml /reference/dom/domdocument importnode.xml
registernodeclass.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6145@lists.php.net to get a copy of this message
yannick Sun Dec 7 20:13:55 2008 UTC Modified files: /phpdoc-fr/reference/datetime/functions date-default-timezone-get.xml date-default-timezone-set.xml date-format.xml date-isodate-set.xml date-modify.xml date-offset-get.xml date-time-set.xml date-timezone-get.xml date-timezone-set.xml date.xml localtime.xml mktime.xml strftime.xml timezone-identifiers-list.xml timezone-name-get.xml timezone-offset-get.xml timezone-transitions-get.xml /phpdoc-fr/reference/dom/domdocument importnode.xml registernodeclass.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-default-timezone-get.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-default-timezone-get.xml diff -u phpdoc-fr/reference/datetime/functions/date-default-timezone-get.xml:1.7 phpdoc-fr/reference/datetime/functions/date-default-timezone-get.xml:1.8 --- phpdoc-fr/reference/datetime/functions/date-default-timezone-get.xml:1.7 Tue Oct 9 21:29:43 2007 +++ phpdoc-fr/reference/datetime/functions/date-default-timezone-get.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-default-timezone-get" xmlns="http://docbook.org/ns/docbook"> @@ -17,37 +17,37 @@ <void/> </methodsynopsis> <para> - Cette fonction retourne le décalage horaire par défaut, utilisant l'ordre suivant : + Cette fonction retourne le décalage horaireen suivant l'ordre de préférence suivant : <itemizedlist> <listitem> <para> - Le décalage horaire est définie en utilisant la fonction + Lecture du décalage horaire définie en utilisant la fonction <function>date_default_timezone_set</function> (si elle existe) </para> </listitem> <listitem> <para> - La variable d'environnement <varname>TZ</varname> (si elle n'est pas vide) + Lecture de la variable d'environnement <varname>TZ</varname> (si elle n'est pas vide) </para> </listitem> <listitem> <para> - L'option de configuration <link linkend="ini.date.timezone">date.timezone</link> + Lecture de la valeur de l'option de configuration + <link linkend="ini.date.timezone">date.timezone</link> (si elle est définie) </para> </listitem> <listitem> <para> - Interrogation magique (si le système le supporte) - </para> - </listitem> - <listitem> - <para> - Si aucune des options suivantes ne réussissent, retourne <literal>UTC</literal> + Interrogation du système d'exploitation (si le système le supporte et l'autorise) </para> </listitem> </itemizedlist> - </para> + </para> + <para> + Si tout ce qui précède échoue, <methodname>date_default_timezone_get</methodname> + retournera le décalage horaire par défaut de <literal>UTC</literal>. + </para> </refsect1> <refsect1 role="returnvalues"> @@ -57,6 +57,57 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Récupération du décalage horaire par défaut</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +if (date_default_timezone_get()) { + echo 'date_default_timezone_set : ' . date_default_timezone_get() . '<br />'; +} + +if (ini_get('date.timezone')) { + echo 'date.timezone : ' . ini_get('date.timezone'); +} + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +date_default_timezone_set : Europe/London +date.timezone : Europe/London +]]> + </screen> + </example> + </para> + <para> + <example> + <title>Récupération de l'abréviation d'un décalage horaire</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('America/Los_Angeles'); +echo date_default_timezone_get() . ' => ' . date('e') . ' => ' . date('T'); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +America/Los_Angeles => America/Los_Angeles => PST +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-default-timezone-set.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-default-timezone-set.xml diff -u phpdoc-fr/reference/datetime/functions/date-default-timezone-set.xml:1.10 phpdoc-fr/reference/datetime/functions/date-default-timezone-set.xml:1.11 --- phpdoc-fr/reference/datetime/functions/date-default-timezone-set.xml:1.10 Sat Jun 21 20:51:29 2008 +++ phpdoc-fr/reference/datetime/functions/date-default-timezone-set.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-default-timezone-set" xmlns="http://docbook.org/ns/docbook"> @@ -63,6 +63,30 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Récupération du décalage horaire par défaut</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('America/Los_Angeles'); + +$script_tz = date_default_timezone_get(); + +if (strcmp($script_tz, ini_get('date.timezone'))){ + echo 'Le décalage horaire du script diffère du décalage horaire défini dans le fichier ini.'; +} else { + echo 'Le décalage horaire du script est équivalent à celui défini dans le fichier ini.'; +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-format.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-format.xml diff -u phpdoc-fr/reference/datetime/functions/date-format.xml:1.3 phpdoc-fr/reference/datetime/functions/date-format.xml:1.4 --- phpdoc-fr/reference/datetime/functions/date-format.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-format.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-format" xmlns="http://docbook.org/ns/docbook"> @@ -25,14 +25,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; <varlistentry> <term><parameter>format</parameter></term> <listitem> @@ -52,6 +45,50 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Affichage de la date et de l'heure, de façon procédurale</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = date_create('2008-08-03 14:52:10'); +echo date_format($datetime, 'jS, F Y') . "\n"; +echo date_format($datetime, DATE_ATOM); +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Affichage de la date et de l'heure, de façon orientée objet</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = new DateTime('2008-08-03 14:52:10'); +echo $datetime->format('jS, F Y') . "\n"; +echo $datetime->format(DATE_ATOM); +?> +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +3rd, August 2008 +2008-08-03T14:52:10+01:00 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-isodate-set.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-isodate-set.xml diff -u phpdoc-fr/reference/datetime/functions/date-isodate-set.xml:1.3 phpdoc-fr/reference/datetime/functions/date-isodate-set.xml:1.4 --- phpdoc-fr/reference/datetime/functions/date-isodate-set.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-isodate-set.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-isodate-set" xmlns="http://docbook.org/ns/docbook"> @@ -23,20 +23,17 @@ <methodparam><type>int</type><parameter>week</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> </methodsynopsis> + <para> + Définit une date suivant le standard ISO 8601, en utilisant la position de la + semaine et du jour, plutôt qu'en spécifiant une date. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; <varlistentry> <term><parameter>year</parameter></term> <listitem> @@ -57,7 +54,7 @@ <term><parameter>day</parameter></term> <listitem> <para> - Jour de la date. + Position du jour par rapport au premier jour de la semaine. </para> </listitem> </varlistentry> @@ -72,6 +69,45 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Recherche de la date depuis un numéro de semaine et de jour</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = new DateTime(); + +// Position depuis le début de la semaine 2 (7) = 5 +$datetime->setISODate(2008, 2, 5); // Le jour 5 de la semaine 2 de l'année 2008 correspond au 11 Janvier. + +// Position depuis le début de la semaine 2 (7) = 10 +$datetime->setISODate(2008, 2, 10); // Le jour 10 de la semaine 2 de l'année 2008 correspond au 16 Janvier. +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Recherche du mois correspondant à une semaine</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = date_create(); +date_isodate_set($datetime, 2008, 6); // La semaine 6 de l'année 2008 est en Février. +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-modify.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-modify.xml diff -u phpdoc-fr/reference/datetime/functions/date-modify.xml:1.3 phpdoc-fr/reference/datetime/functions/date-modify.xml:1.4 --- phpdoc-fr/reference/datetime/functions/date-modify.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-modify.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-modify" xmlns="http://docbook.org/ns/docbook"> @@ -19,20 +19,17 @@ <type>void</type><methodname>DateTime::modify</methodname> <methodparam><type>string</type><parameter>modify</parameter></methodparam> </methodsynopsis> + <para> + Modifie le timestamp d'un objet DateTime par incrément ou décrément, dans un format + accepté par la fonction <function>strtotime</function>. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; <varlistentry> <term><parameter>modify</parameter></term> <listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-offset-get.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-offset-get.xml diff -u phpdoc-fr/reference/datetime/functions/date-offset-get.xml:1.3 phpdoc-fr/reference/datetime/functions/date-offset-get.xml:1.4 --- phpdoc-fr/reference/datetime/functions/date-offset-get.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-offset-get.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-offset-get" xmlns="http://docbook.org/ns/docbook"> @@ -24,14 +24,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; </variablelist> </para> </refsect1> @@ -44,6 +37,28 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Compare les positions entre l'heure d'été et l'heure d'hiver</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$winter = new DateTime('2008-12-25 14:25:41'); +$summer = new DateTime('2008-07-14 14:25:41'); + +echo $winter->getOffset(); // Position de l'hiver : 0 +echo $summer->getOffset(); // Position de l'été : 3600 = 1 heure +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-time-set.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-time-set.xml diff -u phpdoc-fr/reference/datetime/functions/date-time-set.xml:1.3 phpdoc-fr/reference/datetime/functions/date-time-set.xml:1.4 --- phpdoc-fr/reference/datetime/functions/date-time-set.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-time-set.xml Sun Dec 7 20:13:55 2008 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry xml:id="function.date-time-set" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_time_set</refname> @@ -22,20 +23,16 @@ <methodparam><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> </methodsynopsis> + <para> + Réinitialise le temps courant d'un objet DateTime à un temps différent. + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; <varlistentry> <term><parameter>hour</parameter></term> <listitem> @@ -71,6 +68,46 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Modification du temps d'un objet DateTime</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = new DateTime('2008-08-03 12:35:23'); +echo $datetime->format('Y-m-d H:i:s') . "\n"; + +$datetime->setTime(14, 55, 24); +echo $datetime->format('Y-m-d H:i:s') . "\n"; + +// Attention : Ne pas incrémenter l'heure ! +// Car l'heure a déjà été définie (14) - voir date_modify() +$datetime->setTime($datetime->format('H'), $datetime->format('n') + 6); +echo $datetime->format('Y-m-d H:i:s') . "\n"; + +// Incrément du jour, car le jour n'a pas été défini pour le moment +$datetime->setTime($datetime->format('H') + 12, $datetime->format('n')); +echo $datetime->format('Y-m-d H:i:s') . "\n"; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +2008-08-03 12:35:23 +2008-08-03 14:55:24 +2008-08-03 14:14:00 +2008-08-04 02:08:00 +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-timezone-get.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-timezone-get.xml diff -u phpdoc-fr/reference/datetime/functions/date-timezone-get.xml:1.4 phpdoc-fr/reference/datetime/functions/date-timezone-get.xml:1.5 --- phpdoc-fr/reference/datetime/functions/date-timezone-get.xml:1.4 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-timezone-get.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-timezone-get" xmlns="http://docbook.org/ns/docbook"> @@ -24,14 +24,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; </variablelist> </para> </refsect1> @@ -43,11 +36,50 @@ </para> </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Returns DateTimeZone object on success or &false; on failure. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Définition et récupération d'objets DateTimeZone</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = new DateTime('2008-08-03 12:35:23'); +echo $datetime->getTimezone()->getName() . "\n"; + +$datetime = new DateTime('2008-08-03 12:35:23'); +$la_time = new DateTimeZone('America/Los_Angeles'); +$datetime->setTimezone($la_time); +echo $datetime->getTimezone()->getName(); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Europe/London +America/Los_Angeles +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>date_timezone_set</function></member> + <member><function>timezone_open</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date-timezone-set.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date-timezone-set.xml diff -u phpdoc-fr/reference/datetime/functions/date-timezone-set.xml:1.4 phpdoc-fr/reference/datetime/functions/date-timezone-set.xml:1.5 --- phpdoc-fr/reference/datetime/functions/date-timezone-set.xml:1.4 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/date-timezone-set.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date-timezone-set" xmlns="http://docbook.org/ns/docbook"> @@ -25,14 +25,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTime. - </para> - </listitem> - </varlistentry> + &date.datetime.description; <varlistentry> <term><parameter>timezone</parameter></term> <listitem> @@ -52,11 +45,43 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Définition et récupération d'objets DateTimeZone</title> + <programlisting role="php"> +<![CDATA[ +<?php +date_default_timezone_set('Europe/London'); + +$datetime = new DateTime('2008-08-03 12:35:23'); +echo $datetime->getTimezone()->getName() . "\n"; + +$datetime = new DateTime('2008-08-03 12:35:23'); +$la_time = new DateTimeZone('America/Los_Angeles'); +$datetime->setTimezone($la_time); +echo $datetime->getTimezone()->getName(); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Europe/London +America/Los_Angeles +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>date_timezone_get</function></member> + <member><function>timezone_open</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date.xml?r1=1.47&r2=1.48&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date.xml diff -u phpdoc-fr/reference/datetime/functions/date.xml:1.47 phpdoc-fr/reference/datetime/functions/date.xml:1.48 --- phpdoc-fr/reference/datetime/functions/date.xml:1.47 Sat Jun 21 20:51:29 2008 +++ phpdoc-fr/reference/datetime/functions/date.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.47 $ --> -<!-- EN-Revision: 1.42 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.48 $ --> +<!-- EN-Revision: 1.43 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.date" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -219,7 +219,7 @@ </row> <row> <entry><literal>u</literal></entry> - <entry>Millisecondes (ajouté en PHP 5.2.2)</entry> + <entry>Microsecondes (ajouté en PHP 5.2.2)</entry> <entry>Exemple : <literal>54321</literal></entry> </row> <row> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/localtime.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/datetime/functions/localtime.xml diff -u phpdoc-fr/reference/datetime/functions/localtime.xml:1.14 phpdoc-fr/reference/datetime/functions/localtime.xml:1.15 --- phpdoc-fr/reference/datetime/functions/localtime.xml:1.14 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/localtime.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/mktime.xml?r1=1.28&r2=1.29&diff_format=u Index: phpdoc-fr/reference/datetime/functions/mktime.xml diff -u phpdoc-fr/reference/datetime/functions/mktime.xml:1.28 phpdoc-fr/reference/datetime/functions/mktime.xml:1.29 --- phpdoc-fr/reference/datetime/functions/mktime.xml:1.28 Sat Jun 21 20:51:29 2008 +++ phpdoc-fr/reference/datetime/functions/mktime.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.28 $ --> -<!-- EN-Revision: 1.24 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.29 $ --> +<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.mktime" xmlns="http://docbook.org/ns/docbook"> @@ -151,6 +151,14 @@ </thead> <tbody> <row> + <entry>5.3.0</entry> + <entry> + <function>mktime</function> lance maintenant une alerte de type + <literal>E_DEPRECATED</literal> si le paramètre + <parameter>is_dst</parameter> est utilisé. + </entry> + </row> + <row> <entry>3.0.10</entry> <entry>Ajout du paramètre <parameter>is_dst</parameter></entry> </row> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/strftime.xml?r1=1.27&r2=1.28&diff_format=u Index: phpdoc-fr/reference/datetime/functions/strftime.xml diff -u phpdoc-fr/reference/datetime/functions/strftime.xml:1.27 phpdoc-fr/reference/datetime/functions/strftime.xml:1.28 --- phpdoc-fr/reference/datetime/functions/strftime.xml:1.27 Sat Jun 21 20:51:29 2008 +++ phpdoc-fr/reference/datetime/functions/strftime.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.27 $ --> -<!-- EN-Revision: 1.22 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.28 $ --> +<!-- EN-Revision: 1.25 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -145,8 +145,14 @@ </listitem> <listitem> <simpara> - %p - soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction - des valeurs enregistrées en local + %p - `AM' ou `PM', en majuscule, suivant la valeur donnée, ou la chaîne + correspondante pour la locale courante + </simpara> + </listitem> + <listitem> + <simpara> + %P - `am' ou `pm', en majuscule, suivant la valeur donnée, ou la chaîne + correspondante à la locale courante </simpara> </listitem> <listitem> @@ -237,7 +243,8 @@ </listitem> <listitem> <simpara> - %Z ou %z - fuseau horaire, ou nom ou abréviation + %Z ou %z - fuseau horaire, ou nom ou abréviation (suivant le système + d'exploitation) </simpara> </listitem> <listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/timezone-identifiers-list.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/datetime/functions/timezone-identifiers-list.xml diff -u phpdoc-fr/reference/datetime/functions/timezone-identifiers-list.xml:1.5 phpdoc-fr/reference/datetime/functions/timezone-identifiers-list.xml:1.6 --- phpdoc-fr/reference/datetime/functions/timezone-identifiers-list.xml:1.5 Tue Feb 26 16:01:39 2008 +++ phpdoc-fr/reference/datetime/functions/timezone-identifiers-list.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.timezone-identifiers-list" xmlns="http://docbook.org/ns/docbook"> @@ -12,14 +12,43 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>timezone_identifiers_list</methodname> - <void/> + <methodparam><type>int</type><parameter>what</parameter></methodparam> + <methodparam><type>string</type><parameter>option</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>array</type><methodname>DateTimeZone::listIdentifiers</methodname> - <void/> + <methodparam><type>int</type><parameter>what</parameter></methodparam> + <methodparam><type>string</type><parameter>country</parameter></methodparam> </methodsynopsis> </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &date.datetime.description; + <varlistentry> + <term><parameter>what</parameter></term> + <listitem> + <para> + Une constante <classname>DateTimeZone</classname> et par défaut, + <constant>DateTimeZone::ALL</constant>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>country</parameter></term> + <listitem> + <para> + Le code pays, sur 2 lettres, compatible + ISO 3166-1. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/timezone-name-get.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/timezone-name-get.xml diff -u phpdoc-fr/reference/datetime/functions/timezone-name-get.xml:1.3 phpdoc-fr/reference/datetime/functions/timezone-name-get.xml:1.4 --- phpdoc-fr/reference/datetime/functions/timezone-name-get.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/timezone-name-get.xml Sun Dec 7 20:13:55 2008 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry xml:id="function.timezone-name-get" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>timezone_name_get</refname> @@ -23,14 +24,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTimeZone. - </para> - </listitem> - </varlistentry> + &date.datetimezone.description; </variablelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/timezone-offset-get.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/datetime/functions/timezone-offset-get.xml diff -u phpdoc-fr/reference/datetime/functions/timezone-offset-get.xml:1.5 phpdoc-fr/reference/datetime/functions/timezone-offset-get.xml:1.6 --- phpdoc-fr/reference/datetime/functions/timezone-offset-get.xml:1.5 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/timezone-offset-get.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.timezone-offset-get" xmlns="http://docbook.org/ns/docbook"> @@ -31,14 +31,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTimeZone. - </para> - </listitem> - </varlistentry> + &date.datetimezone.description; <varlistentry> <term><parameter>datetime</parameter></term> <listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/timezone-transitions-get.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/datetime/functions/timezone-transitions-get.xml diff -u phpdoc-fr/reference/datetime/functions/timezone-transitions-get.xml:1.3 phpdoc-fr/reference/datetime/functions/timezone-transitions-get.xml:1.4 --- phpdoc-fr/reference/datetime/functions/timezone-transitions-get.xml:1.3 Sun Jul 22 17:47:27 2007 +++ phpdoc-fr/reference/datetime/functions/timezone-transitions-get.xml Sun Dec 7 20:13:55 2008 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry xml:id="function.timezone-transitions-get" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>timezone_transitions_get</refname> @@ -23,14 +24,7 @@ &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>object</parameter></term> - <listitem> - <para> - Objet DateTimeZone. - </para> - </listitem> - </varlistentry> + &date.datetimezone.description; </variablelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/dom/domdocument/importnode.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/dom/domdocument/importnode.xml diff -u phpdoc-fr/reference/dom/domdocument/importnode.xml:1.2 phpdoc-fr/reference/dom/domdocument/importnode.xml:1.3 --- phpdoc-fr/reference/dom/domdocument/importnode.xml:1.2 Mon Dec 1 20:55:59 2008 +++ phpdoc-fr/reference/dom/domdocument/importnode.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="domdocument.importnode" xmlns="http://docbook.org/ns/docbook"> @@ -40,6 +40,12 @@ récursivement le sous-arbre situé sous le noeud <parameter>importedNode</parameter>. </para> + <note> + <para> + Pour copier les attributs des noeuds, le paramètre + <parameter>deep</parameter> doit être défini à &true; + </para> + </note> </listitem> </varlistentry> </variablelist> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/dom/domdocument/registernodeclass.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/dom/domdocument/registernodeclass.xml diff -u phpdoc-fr/reference/dom/domdocument/registernodeclass.xml:1.4 phpdoc-fr/reference/dom/domdocument/registernodeclass.xml:1.5 --- phpdoc-fr/reference/dom/domdocument/registernodeclass.xml:1.4 Mon Dec 1 20:55:59 2008 +++ phpdoc-fr/reference/dom/domdocument/registernodeclass.xml Sun Dec 7 20:13:55 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="domdocument.registernodeclass" xmlns="http://docbook.org/ns/docbook"> @@ -36,11 +36,6 @@ La classe DOM qui vous voulez étendre. Vous pouvez trouver une liste de ces classes dans l'<link linkend="book.dom">introduction du chapitre</link>. </para> - <para> - Bien sûr, vous ne pouvez pas enregistrer une classe étendant DOMDocument - mais vous pouvez toujours commencer votre document en instanciant - votre propre classe étendue. - </para> </listitem> </varlistentry> <varlistentry> @@ -175,6 +170,53 @@ </example> </para> + <para> + <example> + <title>Récupération du propriétaire du document</title> + <para> + Lors de l'instanciation d'un <classname>DOMDocument</classname> + personnalisé, la propriété <varname>ownerDocument</varname> se réfère + à la classe instanciée, signifiant qu'il n'est pas nécessaire (et en fait, + par possible) d'utiliser + <function>DOMDocument::registerNodeClass</function> avec + <classname>DOMDocument</classname> + </para> + <programlisting role="php"> +<![CDATA[ +<?php +class myDOMDocument extends DOMDocument { +} + +class myOtherDOMDocument extends DOMDocument { +} + +// Création d'un document myDOMDocument avec quelques fragments XML +$doc = new myDOMDocument; +$doc->loadXML("<root><element><child>texte dans un fils</child></element></root>"); + +$child = $doc->getElementsByTagName("child")->item(0); + +// Le propriétaire courant du noeud est myDOMDocument +var_dump(get_class($child->ownerDocument)); + +// Importation d'un noeud depuis myDOMDocument +$newdoc = new myOtherDOMDocument; +$child = $newdoc->importNode($child); + +// Le nouveau propriétaire du noeud a changé en myOtherDOMDocument +var_dump(get_class($child->ownerDocument)); +?> +]]> + </programlisting> + &example.outputs; + <screen role="xml"> +<![CDATA[ +string(13) "myDOMDocument" +string(18) "myOtherDOMDocument" +]]> + </screen> + </example> + </para> </refsect1> </refentry>
« previous php.doc.fr (#6145) next »