cvs: peardoc /fr/package/datetime/calendar faq.xml
| From: | romainBourdon | Date: | Tue, 30 Mar 2004 12:11:49 +0000 |
| Subject: | cvs: peardoc /fr/package/datetime/calendar faq.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-3155@lists.php.net to get a copy of this message | ||
romain Tue Mar 30 07:11:49 2004 EDT
Modified files:
/peardoc/fr/package/datetime/calendar faq.xml
Log:
First translation
http://cvs.php.net/diff.php/peardoc/fr/package/datetime/calendar/faq.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/datetime/calendar/faq.xml diff -u peardoc/fr/package/datetime/calendar/faq.xml:1.1 peardoc/fr/package/datetime/calendar/faq.xml:1.2 --- peardoc/fr/package/datetime/calendar/faq.xml:1.1 Wed Mar 24 09:55:22 2004 +++ peardoc/fr/package/datetime/calendar/faq.xml Tue Mar 30 07:11:48 2004 @@ -1,60 +1,45 @@ -<?xml version="1.0" ?> -<!-- $Id: faq.xml,v 1.1 2004/03/24 14:55:22 didou Exp $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: partial --> +<!-- $Id: faq.xml,v 1.2 2004/03/30 12:11:48 romain Exp $ --> +<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- Reviewed: no --> <refentry id="package.datetime.calendar.faq"> <refnamediv> <refname>FAQ</refname> <refpurpose> - Foire Aux Questions + Questions Fréquemment Posées </refpurpose> </refnamediv> <refsect1> - <title>Pourquoi ce n'est pas du HTML qui est généré ?</title> + <title>Pourquoi est ce que ça ne permet pas de générer pas du HTML?</title> <para> - Et si vous vouliez du WML, SOAP, PDF, GIF, ligne de commande, etc. etc.? PEAR::Calendar peut - être utilisé pour générer le type de format que vous voulez (voyez les exemples pour SOAP et - WML). Le contonner à un type particulier de rendu limiterai son utilisation (c'est le problème - de toutes les librairies PHP de génération de calendriers que j'ai connu). Un package comme - PEAR::HTML_Calendar pourrait être développé avec PEAR::Calendar. + Si vous souhaitez des formats WML, SOAP, PDF, GIF, ligne de commande, etc. etc.? PEAR::Calendar peut être utilisé pour générer n'importe quel format(voir les exemples pour SOAP et WML). Par contre, l'utilisation d'un format limitera ses possibilités (un problème rencontré sur toutes les librairies PHP consultées). </para> </refsect1> <refsect1> - <title>Il y'a trop d'objets, de classes et de fichiers, c'est une usine à gaz !</title> + <title>Il y a trop d'objets, de classes et de fichiers!</title> <para> - En testant les exemples sur les serveurs de Sourceforge (qui sont toujours surchargés), - example3.php s'exécute en 0.1 seconde (et même moins). Le code est extremement optimisé et - chaque astuce connue a été appliquée pour être sûr que PHP n'exécute que la portion de code dont - vous avez besoin. Si vous en doutez, utilisez <classname>Cache_Lite</classname> pour mettre en - cache le rendu HTML. + En lançant les exemples sur les serveurs de Sourceforge (qui sont toujours surchargés), le script example 3.php s'exécute en 0.1 secondes (généralement deux fois plus rapide). Le code est optimisé et tout à été mis en place pour que PHP ne parse / exécute que le stricte nécessaire. En cas de doute, utilisez<classname>Cache_Lite</classname> afin de mettre votre HTML en cache. </para> </refsect1> <refsect1> - <title>Vous utilisez des timestamps Unix pour calculer le calendrier, ce qui limite l'intervalle - des années pouvant être générées. Peut-on changer cela ?</title> + <title>Vous utilisez des timestamps Unix pour calculer le calendrier ce qui limite le nombre d'années que l'on peut générer. Peut on modifier cela ?</title> <para> - All calculations are handled by a class implementing the Calendar_Engine interface. The default - implemention is based on PHP's <function>date</function> and <function>mktime</function> - functions (so timestamp Unixs are required for that engine). A second engine exists which uses - PEAR::Date. It's slower but overcomes the limit on the range of Unixstamps. To switch between - engines use the constant <constant>CALENDAR_ENGINE</constant> e.g. + Tous les calculs sont gérés par une classe utilisant l'interface Calendar_Engine. L'implémentation par défaut est basée sur les fonctions <function>date</function> et <function>mktime</function> de PHP (les timestamps unix sont nécessaires pour ce moteur). Un second moteur utilisant PEAR::Date existe. Il est plus lent mais répond au problème de limite d'années. Pour passer d'un moteur à l'autre, utilisez la constante <constant>CALENDAR_ENGINE</constant>. <programlisting role="php"> <![CDATA[ -<?php -// Le moteur par défaut est celui des timestamps UNIX (cet appel n'est pas requis) +// moteur timestamp Unix (valeur par défaut) // define('CALENDAR_ENGINE', 'UnixTs'); -// Passer au moteur PEAR::Date +// avec PEAR::Date engine define('CALENDAR_ENGINE', 'PearDate'); -?> ]]> </programlisting> - Notez que le moteur de PEAR::Date est basé sur la version 1.3 de PEAR Date (il manque un fichier essentiel dans la version 1.3.1beta, ce qui fait qu'elle ne fonctionne pas). + Notez que le moteur de PEAR::Date est basé sur PEAR Date version 1.3. </para> </refsect1> <refsect1> - <title>Ces exemples utilisent la langue anglaise pour les noms. Peut-on changer la langue ?</title> + <title>Ces exemples utilisent la langue anglaise pour les jours et les mois. Peut on changer cela ?</title> <para> - PEAR::Calendar only uses base 10 numbers for calculations - the names of months and days of the week and generated as the calendar is being rendered (by you). You should only need to change PHP's locale with <function>setlocale</function> and use the <function>strftime</function> function e.g.; + PEAR::Calendar n'utilise que des nombres en base 10 pour les calculs - les noms des jours et des mois dépendent de la configuration de votre PHP. Vous pouvez changer cela avec les fonctions<function>setlocale</function> et <function>strftime</function>. <programlisting role="php"> <![CDATA[ $Day = & new Calendar_Day(2003, 10, 23); @@ -64,67 +49,51 @@ echo strftime('%A %d %B %Y', $Day->getTimeStamp()); ]]> </programlisting> - Note that <classname>Calendar_Decorator_Textual</classname> provides help in generating month and day of week names in a manner which is independent of the Calendar Engine you are using and can be modified with <function>setlocale</function>. + Notez que <classname>Calendar_Decorator_Textual</classname> vous aide à générer des noms de mois et de jours de façon indépendante du moteur Calendar que vous utilisez et qui peut être modifié avec <function>setlocale</function>. </para> </refsect1> <refsect1> <title>Que sont les EmptyDays?</title> <para> - PEAR::Calendar makes it easy to render calendars in tabular format (like humans are used to) such as; + PEAR::Calendar aide à générer des calendriers au format tableur tel que; <literallayout> -October 2003 -M T W T F S S - 1 2 3 4 5 -6 7 8 9 10 11 12 -13 14 15 16 17 18 19 -20 21 22 23 24 25 26 -27 28 29 30 31 +Octobre 2003 +M T W T F S S + 1 2 3 4 5 +6 7 8 9 10 11 12 +13 14 15 16 17 18 19 +20 21 22 23 24 25 26 +27 28 29 30 31 </literallayout> - Notice the top left and botton right of this example - these are "EmptyDays". EmptyDays are - generated only by two calendar classes: Calendar_Month_Weekdays and Calendar_Week. For example - using Calendar_Month_Weekdays; + Notez les vides en haut à gauche et en bas à droite de cet exemple - ce sont des "EmptyDays". Les EmptyDays ne sont générés que par deux classes calendar : Calendar_Month_Weekdays et Calendar_Week. Par exemple en utilisant Calendar_Month_Weekdays; <programlisting role="php"> <![CDATA[ -<?php require_once 'Calendar/Month/Weekdays.php'; $Month = & new Calendar_Month_Weekdays(2003, 10); $Month->build(); while ($Day = & $Month->fetch()) { - if ($Day->isFirst()) // Check for the start of a week + if ($Day->isFirst()) // Recherche le premier début de semaine echo "\n"; - if ($Day->isEmpty()) // Check to see if day is empty + if ($Day->isEmpty()) // Verifie si day est vide echo "\t"; else echo $Day->thisDay()."\t"; - if ($Day->isLast()) // Check for the end of a week + if ($Day->isLast()) // Recherche la fin de la semaine echo "\n"; } -?> ]]> </programlisting> - An empty day can still return values, the date it represents being from the previous or next - month in the calendar. You may get empty days for <classname>Calendar_Month_Weekdays</classname> - and <classname>Calendar_Week</classname>. Using <classname>Calendar_Week</classname>, you will - only build 7 days (use <classname>Calendar_Month_Weeks</classname> to build - <classname>Calendar_Week</classname> objects), so the <function>isFirst</function> and - <function>isLast</function> methods are not applicable. + Un jour vide peut retourner une valeur correspondant à la fin du mois précédent ou au début du mois suivant. Vous pouvez obtenir des jours vides avec <classname>Calendar_Month_Weekdays</classname> et <classname>Calendar_Week</classname>. <classname>Calendar_Week</classname>vous permettra de construire 7 jours (utilisez <classname>Calendar_Month_Weeks</classname> pour construire des objets <classname>Calendar_Week</classname>), ainsi les <function>isFirst</function> et <function>isLast</function> ne sont plus applicables. </para> </refsect1> <refsect1> - <title>How do I select some dates?</title> + <title>Comment fait on poour sélectionner des dates ?</title> <para> - All calendar objects (except <classname>Calendar_Second</classname>, which has no "children") - have the method <function>build</function> to build the "children" of that object. For example - <classname>Calendar_Year</classname>::<function>build</function> builds - <classname>Calendar_Month</classname> objects while - <classname>Calendar_Hour</classname>::<function>build</function> builds - <classname>Calendar_Minute</classname> objects. You have the option of passing this method an - indexed array of Calendar objects which will be used to "select" the matching built children. - For example; + Tous les objets Calendar (excepté <classname>Calendar_Second</classname>, qui n'as pas de "fils") disposent de la méthode <function>build</function> afin de construire des "fils" de cet objet. Par exemple, <classname>Calendar_Year</classname>::<function>build</function> créé des objets <classname>Calendar_Month</classname> alors que <classname>Calendar_Hour</classname>::<function>build</function> créé un objet <classname>Calendar_Minute</classname>. Vous avez également la possibilité de passer un objet Calendar sous forme de tableau indexé, celui-ci sera utilisé pour "selectionner" le fils correspondant. Par exemple; <programlisting role="php"> <![CDATA[ $Month = & new Calendar_Month(2003, 10); // Oct 2003 @@ -132,7 +101,7 @@ $SelectedDay1 = & new Calendar_Day(2003, 10, 5); Oct 5th 2003 $SelectedDay2 = & new Calendar_Day(2003, 10, 21); Oct 21st 2003 -// Place in an array... +// Placez un tableau... $selection = array($SelectedDay1, $SelectedDay2); $Month->build($selection); @@ -143,33 +112,19 @@ } ]]> </programlisting> - <emphasis>Note:</emphasis> date objects you pass to a <function>build</function> method replace - the corresponding built date objects, allowing you to do things like attach your own subclass of - <classname>Calendar_Decorator</classname> to them, then access the decorating functionality - inside the loop which renders the calendar. You might display the contents from an "events - database table" using this approach. + <emphasis>Note:</emphasis> En passant un objet de type date à la méthode <function>build</function>, vous remplacerez les objets date correspondant, vous permettant par exemple d'attacher votre propre sous classe de <classname>Calendar_Decorator</classname> afin de personnaliser votre calendrier. Vous pouvez afficher le contenu d'un événement "events database table" avec cette approche. </para> </refsect1> <refsect1> - <title>Why do I have to call build() explicitly. Why can't children be built automatically?</title> + <title>Pourquoi dois-je appeler build() explicitement. Pourquoi les fils ne se créent ils pas automatiquement?</title> <para> - First and foremost, for performance. Building the children has a performance cost and you won't - always need to have the children, so it should be called explicitly, otherwise you might have - $Year->build(), expecting to get just months but behind the scenes, months built days, which - built hours, which build minutes etc. Also calling <function>build</function> yourself give - you a chance to "select" some of the children. + Avant tout, pour les performances. Construire un fils coûte en performances alors que cela n'est pas toujours nécessaire. Avec un appel automatique, un appel à $Year->build() construirait les mois mais aussi les jours, les heures, les minutes etc. L'appel explicite de <function>build</function> vous permet également de sélectionner vos fils. </para> </refsect1> <refsect1> - <title>How do I validate a date?</title> + <title>Comment valide t'on une date?</title> <para> - Validity is determined by the Caalendar_Engine being used as well as the time the date object - you're working with represents (e.g. $Month = & new Month(2003, 2, 29); is invalid, because - Feb 2003 was not a leap year). For quick validation, you can call the method - <function>isValid</function> on any date object, which will return FALSE if there's a problem. - For more information of more detailed validation, you can call the method - <function>getValidator</function> on any date object, which returns an instance of the class - <classname>Calendar_Validator</classname>. For example; + La validité est déterminée par le Calendar_Engine (par exemple $Month = & new Month(2003, 2, 29); est invalide, car 2003 n'est pas une année bissextile). Pour une validation rapide, vous pouvez appeler la méthode <function>isValid</function> sur n'importe quel objet de date, cela vous renverra FALSE en cas de problème. Pour plus d'informations ou une validation plus détaillée, vous pouvez appeler la méthode <function>getValidator</function> qu renvoie une instance de la classe <classname>Calendar_Validator</classname>. Par exemple; <programlisting role="php"> <![CDATA[ $Month = & new Month(2003, 2, 29); // 29th Feb 2003 (?!?) @@ -181,79 +136,57 @@ } ]]> </programlisting> - You can also begin validation by calling <function>getValidator</function> then either - <function>isValidYear</function>, <function>isValidMonth</function>, - <function>isValidDay</function>, <function>isValidHour</function>, - <function>isValidMinute</function> and <function>isValidSecond</function> - (or just <function>isValid</function> which calls all of the isValidxxx methods). + Pous pouvez également vérifier une validité en appelant la méthode <function>getValidator</function> puis <function>isValidYear</function>, <function>isValidMonth</function>, <function>isValidDay</function>, <function>isValidHour</function>, <function>isValidMinute</function> ou <function>isValidSecond</function> (ou encore <function>isValid</function> qui appelle toutes les méthodes isValidxxx). </para> </refsect1> <refsect1> - <title>Can I adjust invalid dates?</title> + <title>Puis-je adapter des dates invalides?</title> <para> - If you're allowing end users to navigate your calendar via the URL, were they to modify the URL - to something like calendar.php?year=2003&month=13, instead of throwing a validation error at - them, you could call the <classname>Calendar</classname>::<function>adjust</function> method on - the calendar object you create with that URL. You should then end up with January 2004 (in this - example). This behaviour is possible thanks to <function>mktime</function> for the Unix - Timestamp engine, while being built into the PEAR Date engine for you. + Si vous permettez par exemple à vos utilisateurs de se déplacer dans votre calendrier grâce aux URLs (ex: calendar.php?year=2003&month=13), il se peut qu'ils modifient cette ULR vers une date invalide. Au lieu de leur afficher un message d'erreur, appelez la méthode <classname>Calendar</classname>::<function>adjust</function> sur l'objet Calendar créé. Notre exemple vous donnera alors Janvier 2004. Ce comportement est possible grâce à la fonction <function>mktime</function> pour les Timestamp Unix utilisés dans PEAR. </para> </refsect1> <refsect1> - <title>Après avoir appelé build(), I just want to get a single child date object with looping through the lot. How?</title> + <title>Après un appel à build(), je souhaite avoir un seul objet fils permettant de voir son contenu, comment faire?</title> <para> - The method <function>fetchAll</function> can be called on any date object to get an indexed - array of all the children which have been built, allowing you to reference them directly. Be - careful with the first index of this array - in some cases it will be [1] not [0], depending on - the type of date object built. For example; + La méthode <function>fetchAll</function> peut être appelée pour n'importe quel objet afin d'obtenir un tableau indexé comportant tous les enfants construits, et vous permettant d'y accéder. Faites attention au premier index de ce tableau - dans certains cas, ce sera [1] et non [0] en fonction du type de l'objet construit. Par exemple; <programlisting role="php"> <![CDATA[ $Month = & new Calendar_Month(2003, 10); $Month->build(); -$days = & $Month->fetchAll(); // Now all in array -echo $days[1]->thisDay(); // The first day has index 1 +$days = & $Month->fetchAll(); // on créé le tableau +echo $days[1]->thisDay(); // Le premier jour à l'index 1 $Hour = & new Calendar_Hour(2003, 10, 25, 15); // Oct 25th 2003, 3pm $Hour->build(); -$hours = & $Hour->fetchAll(); // Now all in array -echo $hours[0]->thisHour(); // The first hour has index 0 +$hours = & $Hour->fetchAll(); // on créé le tableau +echo $hours[0]->thisHour(); // La première heure à l'index 0 ]]> </programlisting> - The following classes are always built to have the first index as 1: <classname>Calendar_Month - </classname>, <classname>Calendar_Month_Weekdays</classname>, <classname>Calendar_Month_Weeks - </classname>, <classname>Calendar_Week</classname> and <classname>Calendar_Day</classname> - The following classes are always built to have the first index as 0: <classname>Calendar_Hour - </classname>, <classname>Calendar_Minute</classname> and <classname>Calendar_Second</classname> + Les classes suivantes sont toujours construites avec un premier index à 1: <classname>Calendar_Month</classname>, <classname>Calendar_Month_Weekdays</classname>, <classname>Calendar_Month_Weeks</classname>, <classname>Calendar_Week</classname> et <classname>Calendar_Day</classname> + Les classes suivantes sont toujours construites avec un premier index à 0: <classname>Calendar_Hour</classname>, <classname>Calendar_Minute</classname> et <classname>Calendar_Second</classname> - Note also the method <function>size</function> can be called on any date object, after - <function>build</function> has been called, to get the number of children. + La méthode <function>size</function> peut également être appelée après la méthode <function>build</function> sur les objets date. Elle renvoie le nombre de fils. </para> </refsect1> <refsect1> - <title>What does a week actually represent in PEAR::Calendar?</title> + <title>Comment sont représentées les semaines avec PEAR::Calendar?</title> <para> - Weeks are "pseudo" dates. They're useful for formatting the user interface for end users. Weeks - are instantiated with a year, a month and a day of the month. You can then have the week tell - you its timestamp (which will be the same as the timestamp for the first day in the week), its - numeric position within the <emphasis>tabular</emphasis> month (see Empty Days above), its - numeric position within the year (this is an ISO-8601 week number of year, weeks starting on - Monday) or an array containing the numeric year, month and the first day of the week (as a - number within the month). For example; + Les semaines sont des "pseudo" jours. Ils sont pratiques pour mettre en page vos calendriers. Les semaines sont créées à partir d'un an, un mois et un jour du mois. Vous pouvez alors consulter le timestamp de la semaine qui sera le même que celui du début de cette semaine. Vous pourrez également connaître sa position numérique dans le mois month, sa position numérique dans l'année (il s'agit d'un numéro ISO-8601 de semaine, les semaines commençant par un lundi) ou un tableau contenant les valeurs numériques de l'année, du mois et du premier jour de la semaine (sous la forme d'un nombre dans le mois). Par exemple; <programlisting role="php"> <![CDATA[ $Week = & new Calendar_Week(2003, 10, 15); $Week = new Calendar_Week(2003, 10, 15); -echo $Week->thisWeek(); // Displays 2 (week num in month) -echo $Week->thisWeek('n_in_month'); // Display 2 - same as above +echo $Week->thisWeek(); // affiche 2 (semaine dans le mois) +echo $Week->thisWeek('n_in_month'); // affiche 2 - idem -echo $Week->thisWeek('n_in_year'); // Displays 41 (week in year) +echo $Week->thisWeek('n_in_year'); // affiche 41 (semaine dans l'année) -echo $Week->thisWeek('timestamp'); // Displays unix timestamp or an ISO-8601 datetime - // (YYYY-MM-DD HH:MM:SS), depending on the engine. +echo $Week->thisWeek('timestamp'); // affiche un timestamp Unix ou un datetime ISO-8601 + // (YYYY-MM-DD HH:MM:SS), en fonction du moteur. print_r $Week->thisWeek('array'); // [year] => 2003 [month] => 10 [day] => 12 ]]> @@ -261,33 +194,27 @@ </para> </refsect1> <refsect1> - <title>How do I get a Calendar_Year to build Calendar_Month_Weekdays or Calendar_Month_Weeks, instead of the default Calendar_Month objects?</title> + <title>Comment faire pour qu'un Calendar_Year construise un Calendar_Month_Weekdays ou un Calendar_Month_Weeks, au lieu d'un objet Calendar_Month?</title> <para> - When working with a <classname>Calendar_Year</classname>, the constants <constant> - CALENDAR_MONTH_STATE</constant> controls what type of month object is built. You can define - <constant>CALENDAR_MONTH_STATE</constant> to <constant>CALENDAR_USE_MONTH_WEEKDAYS</constant> or - <constant>CALENDAR_USE_MONTH_WEEKS</constant> for the Calendar_Month_Weekdays and <classname> - Calendar_Month_Week</classname> classes, respectively. + Lorsque vous utilisez un <classname>Calendar_Year</classname>, la constante <constant>CALENDAR_MONTH_STATE</constant> vous permet de contrôler le type d'objets month qui seront créés. Vous pouvez définir <constant>CALENDAR_MONTH_STATE</constant> aux valeurs <constant>CALENDAR_USE_MONTH_WEEKDAYS</constant> ou <constant>CALENDAR_USE_MONTH_WEEKS</constant> respectivement pour les Calendar_Month_Weekdays et les <classname>Calendar_Month_Week</classname>. </para> </refsect1> <refsect1> - <title>Vous utilisez Lundi comme premier jour de la semaine, puis-je changer ?</title> + <title>Vous utilisez le lundi comme début de semaine. Est il possible de changer cela?</title> <para> - Yes. For the classes which are concerned with the notion of a "week", you can can pass a value - which defines the first day of the week. For the default timestamp based Calendar engine, this - is a number from 0 to 6, 0 being Sunday through to 6 being Saturday. - This value can be passed to the following: + Oui. Pour les classes concernées par la notion de "semaine", il vous est possible de passer une valeur permettant de définir le premier jour de la semaine. Cette valeur doit être comprise entre 0 et 6, 0 étant le dimanche et 6 le samedi. + Voici comment passer cette valeur: <programlisting role="php"> <![CDATA[ $Year = new Calendar_Year(2003); $selection = array(); -$Year->build($selection, 0); // the second argument is the first day of the week (Sunday) +$Year->build($selection, 0); // le second argument est le premier jour de la semaine (dimanche) -$MonthWeekdays = new Calendar_Month_Weekdays(2003, 10, 6); // Third argument - Saturday +$MonthWeekdays = new Calendar_Month_Weekdays(2003, 10, 6); // troisième argument - samedi -$MonthWeeks = new Calendar_Month_Weekdays(2003, 10, 2); // Third argument - Tuesday +$MonthWeeks = new Calendar_Month_Weekdays(2003, 10, 2); // troisième argument - mardi -$Week = new Calendar_Week(2003, 10, 15, 5) // Fourth argument - Friday +$Week = new Calendar_Week(2003, 10, 15, 5) // quatrième argument - vendredi ]]> </programlisting> </para> @@ -311,4 +238,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +-->
http://cvs.php.net/diff.php/peardoc/fr/package/datetime/calendar/faq.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/datetime/calendar/faq.xml diff -u peardoc/fr/package/datetime/calendar/faq.xml:1.1 peardoc/fr/package/datetime/calendar/faq.xml:1.2 --- peardoc/fr/package/datetime/calendar/faq.xml:1.1 Wed Mar 24 09:55:22 2004 +++ peardoc/fr/package/datetime/calendar/faq.xml Tue Mar 30 07:11:48 2004 @@ -1,60 +1,45 @@ -<?xml version="1.0" ?> -<!-- $Id: faq.xml,v 1.1 2004/03/24 14:55:22 didou Exp $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: partial --> +<!-- $Id: faq.xml,v 1.2 2004/03/30 12:11:48 romain Exp $ --> +<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- Reviewed: no --> <refentry id="package.datetime.calendar.faq"> <refnamediv> <refname>FAQ</refname> <refpurpose> - Foire Aux Questions + Questions Fréquemment Posées </refpurpose> </refnamediv> <refsect1> - <title>Pourquoi ce n'est pas du HTML qui est généré ?</title> + <title>Pourquoi est ce que ça ne permet pas de générer pas du HTML?</title> <para> - Et si vous vouliez du WML, SOAP, PDF, GIF, ligne de commande, etc. etc.? PEAR::Calendar peut - être utilisé pour générer le type de format que vous voulez (voyez les exemples pour SOAP et - WML). Le contonner à un type particulier de rendu limiterai son utilisation (c'est le problème - de toutes les librairies PHP de génération de calendriers que j'ai connu). Un package comme - PEAR::HTML_Calendar pourrait être développé avec PEAR::Calendar. + Si vous souhaitez des formats WML, SOAP, PDF, GIF, ligne de commande, etc. etc.? PEAR::Calendar peut être utilisé pour générer n'importe quel format(voir les exemples pour SOAP et WML). Par contre, l'utilisation d'un format limitera ses possibilités (un problème rencontré sur toutes les librairies PHP consultées). </para> </refsect1> <refsect1> - <title>Il y'a trop d'objets, de classes et de fichiers, c'est une usine à gaz !</title> + <title>Il y a trop d'objets, de classes et de fichiers!</title> <para> - En testant les exemples sur les serveurs de Sourceforge (qui sont toujours surchargés), - example3.php s'exécute en 0.1 seconde (et même moins). Le code est extremement optimisé et - chaque astuce connue a été appliquée pour être sûr que PHP n'exécute que la portion de code dont - vous avez besoin. Si vous en doutez, utilisez <classname>Cache_Lite</classname> pour mettre en - cache le rendu HTML. + En lançant les exemples sur les serveurs de Sourceforge (qui sont toujours surchargés), le script example 3.php s'exécute en 0.1 secondes (généralement deux fois plus rapide). Le code est optimisé et tout à été mis en place pour que PHP ne parse / exécute que le stricte nécessaire. En cas de doute, utilisez<classname>Cache_Lite</classname> afin de mettre votre HTML en cache. </para> </refsect1> <refsect1> - <title>Vous utilisez des timestamps Unix pour calculer le calendrier, ce qui limite l'intervalle - des années pouvant être générées. Peut-on changer cela ?</title> + <title>Vous utilisez des timestamps Unix pour calculer le calendrier ce qui limite le nombre d'années que l'on peut générer. Peut on modifier cela ?</title> <para> - All calculations are handled by a class implementing the Calendar_Engine interface. The default - implemention is based on PHP's <function>date</function> and <function>mktime</function> - functions (so timestamp Unixs are required for that engine). A second engine exists which uses - PEAR::Date. It's slower but overcomes the limit on the range of Unixstamps. To switch between - engines use the constant <constant>CALENDAR_ENGINE</constant> e.g. + Tous les calculs sont gérés par une classe utilisant l'interface Calendar_Engine. L'implémentation par défaut est basée sur les fonctions <function>date</function> et <function>mktime</function> de PHP (les timestamps unix sont nécessaires pour ce moteur). Un second moteur utilisant PEAR::Date existe. Il est plus lent mais répond au problème de limite d'années. Pour passer d'un moteur à l'autre, utilisez la constante <constant>CALENDAR_ENGINE</constant>. <programlisting role="php"> <![CDATA[ -<?php -// Le moteur par défaut est celui des timestamps UNIX (cet appel n'est pas requis) +// moteur timestamp Unix (valeur par défaut) // define('CALENDAR_ENGINE', 'UnixTs'); -// Passer au moteur PEAR::Date +// avec PEAR::Date engine define('CALENDAR_ENGINE', 'PearDate'); -?> ]]> </programlisting> - Notez que le moteur de PEAR::Date est basé sur la version 1.3 de PEAR Date (il manque un fichier essentiel dans la version 1.3.1beta, ce qui fait qu'elle ne fonctionne pas). + Notez que le moteur de PEAR::Date est basé sur PEAR Date version 1.3. </para> </refsect1> <refsect1> - <title>Ces exemples utilisent la langue anglaise pour les noms. Peut-on changer la langue ?</title> + <title>Ces exemples utilisent la langue anglaise pour les jours et les mois. Peut on changer cela ?</title> <para> - PEAR::Calendar only uses base 10 numbers for calculations - the names of months and days of the week and generated as the calendar is being rendered (by you). You should only need to change PHP's locale with <function>setlocale</function> and use the <function>strftime</function> function e.g.; + PEAR::Calendar n'utilise que des nombres en base 10 pour les calculs - les noms des jours et des mois dépendent de la configuration de votre PHP. Vous pouvez changer cela avec les fonctions<function>setlocale</function> et <function>strftime</function>. <programlisting role="php"> <![CDATA[ $Day = & new Calendar_Day(2003, 10, 23); @@ -64,67 +49,51 @@ echo strftime('%A %d %B %Y', $Day->getTimeStamp()); ]]> </programlisting> - Note that <classname>Calendar_Decorator_Textual</classname> provides help in generating month and day of week names in a manner which is independent of the Calendar Engine you are using and can be modified with <function>setlocale</function>. + Notez que <classname>Calendar_Decorator_Textual</classname> vous aide à générer des noms de mois et de jours de façon indépendante du moteur Calendar que vous utilisez et qui peut être modifié avec <function>setlocale</function>. </para> </refsect1> <refsect1> <title>Que sont les EmptyDays?</title> <para> - PEAR::Calendar makes it easy to render calendars in tabular format (like humans are used to) such as; + PEAR::Calendar aide à générer des calendriers au format tableur tel que; <literallayout> -October 2003 -M T W T F S S - 1 2 3 4 5 -6 7 8 9 10 11 12 -13 14 15 16 17 18 19 -20 21 22 23 24 25 26 -27 28 29 30 31 +Octobre 2003 +M T W T F S S + 1 2 3 4 5 +6 7 8 9 10 11 12 +13 14 15 16 17 18 19 +20 21 22 23 24 25 26 +27 28 29 30 31 </literallayout> - Notice the top left and botton right of this example - these are "EmptyDays". EmptyDays are - generated only by two calendar classes: Calendar_Month_Weekdays and Calendar_Week. For example - using Calendar_Month_Weekdays; + Notez les vides en haut à gauche et en bas à droite de cet exemple - ce sont des "EmptyDays". Les EmptyDays ne sont générés que par deux classes calendar : Calendar_Month_Weekdays et Calendar_Week. Par exemple en utilisant Calendar_Month_Weekdays; <programlisting role="php"> <![CDATA[ -<?php require_once 'Calendar/Month/Weekdays.php'; $Month = & new Calendar_Month_Weekdays(2003, 10); $Month->build(); while ($Day = & $Month->fetch()) { - if ($Day->isFirst()) // Check for the start of a week + if ($Day->isFirst()) // Recherche le premier début de semaine echo "\n"; - if ($Day->isEmpty()) // Check to see if day is empty + if ($Day->isEmpty()) // Verifie si day est vide echo "\t"; else echo $Day->thisDay()."\t"; - if ($Day->isLast()) // Check for the end of a week + if ($Day->isLast()) // Recherche la fin de la semaine echo "\n"; } -?> ]]> </programlisting> - An empty day can still return values, the date it represents being from the previous or next - month in the calendar. You may get empty days for <classname>Calendar_Month_Weekdays</classname> - and <classname>Calendar_Week</classname>. Using <classname>Calendar_Week</classname>, you will - only build 7 days (use <classname>Calendar_Month_Weeks</classname> to build - <classname>Calendar_Week</classname> objects), so the <function>isFirst</function> and - <function>isLast</function> methods are not applicable. + Un jour vide peut retourner une valeur correspondant à la fin du mois précédent ou au début du mois suivant. Vous pouvez obtenir des jours vides avec <classname>Calendar_Month_Weekdays</classname> et <classname>Calendar_Week</classname>. <classname>Calendar_Week</classname>vous permettra de construire 7 jours (utilisez <classname>Calendar_Month_Weeks</classname> pour construire des objets <classname>Calendar_Week</classname>), ainsi les <function>isFirst</function> et <function>isLast</function> ne sont plus applicables. </para> </refsect1> <refsect1> - <title>How do I select some dates?</title> + <title>Comment fait on poour sélectionner des dates ?</title> <para> - All calendar objects (except <classname>Calendar_Second</classname>, which has no "children") - have the method <function>build</function> to build the "children" of that object. For example - <classname>Calendar_Year</classname>::<function>build</function> builds - <classname>Calendar_Month</classname> objects while - <classname>Calendar_Hour</classname>::<function>build</function> builds - <classname>Calendar_Minute</classname> objects. You have the option of passing this method an - indexed array of Calendar objects which will be used to "select" the matching built children. - For example; + Tous les objets Calendar (excepté <classname>Calendar_Second</classname>, qui n'as pas de "fils") disposent de la méthode <function>build</function> afin de construire des "fils" de cet objet. Par exemple, <classname>Calendar_Year</classname>::<function>build</function> créé des objets <classname>Calendar_Month</classname> alors que <classname>Calendar_Hour</classname>::<function>build</function> créé un objet <classname>Calendar_Minute</classname>. Vous avez également la possibilité de passer un objet Calendar sous forme de tableau indexé, celui-ci sera utilisé pour "selectionner" le fils correspondant. Par exemple; <programlisting role="php"> <![CDATA[ $Month = & new Calendar_Month(2003, 10); // Oct 2003 @@ -132,7 +101,7 @@ $SelectedDay1 = & new Calendar_Day(2003, 10, 5); Oct 5th 2003 $SelectedDay2 = & new Calendar_Day(2003, 10, 21); Oct 21st 2003 -// Place in an array... +// Placez un tableau... $selection = array($SelectedDay1, $SelectedDay2); $Month->build($selection); @@ -143,33 +112,19 @@ } ]]> </programlisting> - <emphasis>Note:</emphasis> date objects you pass to a <function>build</function> method replace - the corresponding built date objects, allowing you to do things like attach your own subclass of - <classname>Calendar_Decorator</classname> to them, then access the decorating functionality - inside the loop which renders the calendar. You might display the contents from an "events - database table" using this approach. + <emphasis>Note:</emphasis> En passant un objet de type date à la méthode <function>build</function>, vous remplacerez les objets date correspondant, vous permettant par exemple d'attacher votre propre sous classe de <classname>Calendar_Decorator</classname> afin de personnaliser votre calendrier. Vous pouvez afficher le contenu d'un événement "events database table" avec cette approche. </para> </refsect1> <refsect1> - <title>Why do I have to call build() explicitly. Why can't children be built automatically?</title> + <title>Pourquoi dois-je appeler build() explicitement. Pourquoi les fils ne se créent ils pas automatiquement?</title> <para> - First and foremost, for performance. Building the children has a performance cost and you won't - always need to have the children, so it should be called explicitly, otherwise you might have - $Year->build(), expecting to get just months but behind the scenes, months built days, which - built hours, which build minutes etc. Also calling <function>build</function> yourself give - you a chance to "select" some of the children. + Avant tout, pour les performances. Construire un fils coûte en performances alors que cela n'est pas toujours nécessaire. Avec un appel automatique, un appel à $Year->build() construirait les mois mais aussi les jours, les heures, les minutes etc. L'appel explicite de <function>build</function> vous permet également de sélectionner vos fils. </para> </refsect1> <refsect1> - <title>How do I validate a date?</title> + <title>Comment valide t'on une date?</title> <para> - Validity is determined by the Caalendar_Engine being used as well as the time the date object - you're working with represents (e.g. $Month = & new Month(2003, 2, 29); is invalid, because - Feb 2003 was not a leap year). For quick validation, you can call the method - <function>isValid</function> on any date object, which will return FALSE if there's a problem. - For more information of more detailed validation, you can call the method - <function>getValidator</function> on any date object, which returns an instance of the class - <classname>Calendar_Validator</classname>. For example; + La validité est déterminée par le Calendar_Engine (par exemple $Month = & new Month(2003, 2, 29); est invalide, car 2003 n'est pas une année bissextile). Pour une validation rapide, vous pouvez appeler la méthode <function>isValid</function> sur n'importe quel objet de date, cela vous renverra FALSE en cas de problème. Pour plus d'informations ou une validation plus détaillée, vous pouvez appeler la méthode <function>getValidator</function> qu renvoie une instance de la classe <classname>Calendar_Validator</classname>. Par exemple; <programlisting role="php"> <![CDATA[ $Month = & new Month(2003, 2, 29); // 29th Feb 2003 (?!?) @@ -181,79 +136,57 @@ } ]]> </programlisting> - You can also begin validation by calling <function>getValidator</function> then either - <function>isValidYear</function>, <function>isValidMonth</function>, - <function>isValidDay</function>, <function>isValidHour</function>, - <function>isValidMinute</function> and <function>isValidSecond</function> - (or just <function>isValid</function> which calls all of the isValidxxx methods). + Pous pouvez également vérifier une validité en appelant la méthode <function>getValidator</function> puis <function>isValidYear</function>, <function>isValidMonth</function>, <function>isValidDay</function>, <function>isValidHour</function>, <function>isValidMinute</function> ou <function>isValidSecond</function> (ou encore <function>isValid</function> qui appelle toutes les méthodes isValidxxx). </para> </refsect1> <refsect1> - <title>Can I adjust invalid dates?</title> + <title>Puis-je adapter des dates invalides?</title> <para> - If you're allowing end users to navigate your calendar via the URL, were they to modify the URL - to something like calendar.php?year=2003&month=13, instead of throwing a validation error at - them, you could call the <classname>Calendar</classname>::<function>adjust</function> method on - the calendar object you create with that URL. You should then end up with January 2004 (in this - example). This behaviour is possible thanks to <function>mktime</function> for the Unix - Timestamp engine, while being built into the PEAR Date engine for you. + Si vous permettez par exemple à vos utilisateurs de se déplacer dans votre calendrier grâce aux URLs (ex: calendar.php?year=2003&month=13), il se peut qu'ils modifient cette ULR vers une date invalide. Au lieu de leur afficher un message d'erreur, appelez la méthode <classname>Calendar</classname>::<function>adjust</function> sur l'objet Calendar créé. Notre exemple vous donnera alors Janvier 2004. Ce comportement est possible grâce à la fonction <function>mktime</function> pour les Timestamp Unix utilisés dans PEAR. </para> </refsect1> <refsect1> - <title>Après avoir appelé build(), I just want to get a single child date object with looping through the lot. How?</title> + <title>Après un appel à build(), je souhaite avoir un seul objet fils permettant de voir son contenu, comment faire?</title> <para> - The method <function>fetchAll</function> can be called on any date object to get an indexed - array of all the children which have been built, allowing you to reference them directly. Be - careful with the first index of this array - in some cases it will be [1] not [0], depending on - the type of date object built. For example; + La méthode <function>fetchAll</function> peut être appelée pour n'importe quel objet afin d'obtenir un tableau indexé comportant tous les enfants construits, et vous permettant d'y accéder. Faites attention au premier index de ce tableau - dans certains cas, ce sera [1] et non [0] en fonction du type de l'objet construit. Par exemple; <programlisting role="php"> <![CDATA[ $Month = & new Calendar_Month(2003, 10); $Month->build(); -$days = & $Month->fetchAll(); // Now all in array -echo $days[1]->thisDay(); // The first day has index 1 +$days = & $Month->fetchAll(); // on créé le tableau +echo $days[1]->thisDay(); // Le premier jour à l'index 1 $Hour = & new Calendar_Hour(2003, 10, 25, 15); // Oct 25th 2003, 3pm $Hour->build(); -$hours = & $Hour->fetchAll(); // Now all in array -echo $hours[0]->thisHour(); // The first hour has index 0 +$hours = & $Hour->fetchAll(); // on créé le tableau +echo $hours[0]->thisHour(); // La première heure à l'index 0 ]]> </programlisting> - The following classes are always built to have the first index as 1: <classname>Calendar_Month - </classname>, <classname>Calendar_Month_Weekdays</classname>, <classname>Calendar_Month_Weeks - </classname>, <classname>Calendar_Week</classname> and <classname>Calendar_Day</classname> - The following classes are always built to have the first index as 0: <classname>Calendar_Hour - </classname>, <classname>Calendar_Minute</classname> and <classname>Calendar_Second</classname> + Les classes suivantes sont toujours construites avec un premier index à 1: <classname>Calendar_Month</classname>, <classname>Calendar_Month_Weekdays</classname>, <classname>Calendar_Month_Weeks</classname>, <classname>Calendar_Week</classname> et <classname>Calendar_Day</classname> + Les classes suivantes sont toujours construites avec un premier index à 0: <classname>Calendar_Hour</classname>, <classname>Calendar_Minute</classname> et <classname>Calendar_Second</classname> - Note also the method <function>size</function> can be called on any date object, after - <function>build</function> has been called, to get the number of children. + La méthode <function>size</function> peut également être appelée après la méthode <function>build</function> sur les objets date. Elle renvoie le nombre de fils. </para> </refsect1> <refsect1> - <title>What does a week actually represent in PEAR::Calendar?</title> + <title>Comment sont représentées les semaines avec PEAR::Calendar?</title> <para> - Weeks are "pseudo" dates. They're useful for formatting the user interface for end users. Weeks - are instantiated with a year, a month and a day of the month. You can then have the week tell - you its timestamp (which will be the same as the timestamp for the first day in the week), its - numeric position within the <emphasis>tabular</emphasis> month (see Empty Days above), its - numeric position within the year (this is an ISO-8601 week number of year, weeks starting on - Monday) or an array containing the numeric year, month and the first day of the week (as a - number within the month). For example; + Les semaines sont des "pseudo" jours. Ils sont pratiques pour mettre en page vos calendriers. Les semaines sont créées à partir d'un an, un mois et un jour du mois. Vous pouvez alors consulter le timestamp de la semaine qui sera le même que celui du début de cette semaine. Vous pourrez également connaître sa position numérique dans le mois month, sa position numérique dans l'année (il s'agit d'un numéro ISO-8601 de semaine, les semaines commençant par un lundi) ou un tableau contenant les valeurs numériques de l'année, du mois et du premier jour de la semaine (sous la forme d'un nombre dans le mois). Par exemple; <programlisting role="php"> <![CDATA[ $Week = & new Calendar_Week(2003, 10, 15); $Week = new Calendar_Week(2003, 10, 15); -echo $Week->thisWeek(); // Displays 2 (week num in month) -echo $Week->thisWeek('n_in_month'); // Display 2 - same as above +echo $Week->thisWeek(); // affiche 2 (semaine dans le mois) +echo $Week->thisWeek('n_in_month'); // affiche 2 - idem -echo $Week->thisWeek('n_in_year'); // Displays 41 (week in year) +echo $Week->thisWeek('n_in_year'); // affiche 41 (semaine dans l'année) -echo $Week->thisWeek('timestamp'); // Displays unix timestamp or an ISO-8601 datetime - // (YYYY-MM-DD HH:MM:SS), depending on the engine. +echo $Week->thisWeek('timestamp'); // affiche un timestamp Unix ou un datetime ISO-8601 + // (YYYY-MM-DD HH:MM:SS), en fonction du moteur. print_r $Week->thisWeek('array'); // [year] => 2003 [month] => 10 [day] => 12 ]]> @@ -261,33 +194,27 @@ </para> </refsect1> <refsect1> - <title>How do I get a Calendar_Year to build Calendar_Month_Weekdays or Calendar_Month_Weeks, instead of the default Calendar_Month objects?</title> + <title>Comment faire pour qu'un Calendar_Year construise un Calendar_Month_Weekdays ou un Calendar_Month_Weeks, au lieu d'un objet Calendar_Month?</title> <para> - When working with a <classname>Calendar_Year</classname>, the constants <constant> - CALENDAR_MONTH_STATE</constant> controls what type of month object is built. You can define - <constant>CALENDAR_MONTH_STATE</constant> to <constant>CALENDAR_USE_MONTH_WEEKDAYS</constant> or - <constant>CALENDAR_USE_MONTH_WEEKS</constant> for the Calendar_Month_Weekdays and <classname> - Calendar_Month_Week</classname> classes, respectively. + Lorsque vous utilisez un <classname>Calendar_Year</classname>, la constante <constant>CALENDAR_MONTH_STATE</constant> vous permet de contrôler le type d'objets month qui seront créés. Vous pouvez définir <constant>CALENDAR_MONTH_STATE</constant> aux valeurs <constant>CALENDAR_USE_MONTH_WEEKDAYS</constant> ou <constant>CALENDAR_USE_MONTH_WEEKS</constant> respectivement pour les Calendar_Month_Weekdays et les <classname>Calendar_Month_Week</classname>. </para> </refsect1> <refsect1> - <title>Vous utilisez Lundi comme premier jour de la semaine, puis-je changer ?</title> + <title>Vous utilisez le lundi comme début de semaine. Est il possible de changer cela?</title> <para> - Yes. For the classes which are concerned with the notion of a "week", you can can pass a value - which defines the first day of the week. For the default timestamp based Calendar engine, this - is a number from 0 to 6, 0 being Sunday through to 6 being Saturday. - This value can be passed to the following: + Oui. Pour les classes concernées par la notion de "semaine", il vous est possible de passer une valeur permettant de définir le premier jour de la semaine. Cette valeur doit être comprise entre 0 et 6, 0 étant le dimanche et 6 le samedi. + Voici comment passer cette valeur: <programlisting role="php"> <![CDATA[ $Year = new Calendar_Year(2003); $selection = array(); -$Year->build($selection, 0); // the second argument is the first day of the week (Sunday) +$Year->build($selection, 0); // le second argument est le premier jour de la semaine (dimanche) -$MonthWeekdays = new Calendar_Month_Weekdays(2003, 10, 6); // Third argument - Saturday +$MonthWeekdays = new Calendar_Month_Weekdays(2003, 10, 6); // troisième argument - samedi -$MonthWeeks = new Calendar_Month_Weekdays(2003, 10, 2); // Third argument - Tuesday +$MonthWeeks = new Calendar_Month_Weekdays(2003, 10, 2); // troisième argument - mardi -$Week = new Calendar_Week(2003, 10, 15, 5) // Fourth argument - Friday +$Week = new Calendar_Week(2003, 10, 15, 5) // quatrième argument - vendredi ]]> </programlisting> </para> @@ -311,4 +238,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +-->