documentation/manual/fr/module_specs/Zend_Currency-Value.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20100 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="zend.currency.value">
   5     <title>Travailler avec les valeurs des monnaies (les montants)</title>
   6
   7     <para>
   8         Travailler avec des monnaies c'est avant tout travailler avec des valeurs, des "prix", un montant.
   9         Il faut ainsi travailler avec le montant (la valeur), la précision et l'éventuel taux de change.
  10     </para>
  11
  12     <sect2 id="zend.currency.value.money">
  13         <title>Travailler avec les valeurs des monnaies</title>
  14
  15         <para>
  16             La valeur de la monnaie (le montant) se précise grâce à l'option <property>value</property>.
  17         </para>
  18
  19         <programlisting language="php"><![CDATA[
  20 $currency = new Zend_Currency(
  21     array(
  22         'value'    => 1000,
  23         'currency' => 'USD',
  24     )
  25 );
  26
  27 print $currency; // Retournerait '$ 1.000'
  28 ]]></programlisting>
  29
  30         <para>
  31             Vous pouvez changer la valeur en utilisant les méthodes <methodname>setFormat()</methodname>
  32             ou <methodname>setValue()</methodname>.
  33         </para>
  34
  35         <programlisting language="php"><![CDATA[
  36 $currency = new Zend_Currency(
  37     array(
  38         'value'    => 1000,
  39         'currency' => 'USD',
  40     )
  41 );
  42
  43 print $currency->setValue(2000); // Retournerait '$ 2.000'
  44 ]]></programlisting>
  45
  46         <para>
  47             <methodname>getValue()</methodname> existe aussi.
  48         </para>
  49     </sect2>
  50
  51     <sect2 id="zend.currency.value.precision">
  52         <title>Utiliser la précision des monnaies</title>
  53
  54         <para>
  55             La plupart des monnaies utilisent une précision de 2, ce qui signifie qu'avec 100 dollars US
  56             vous pouvez rajouter 50 cents. C'est simplement le paramètre après la virgule.
  57         </para>
  58
  59         <programlisting language="php"><![CDATA[
  60 $currency = new Zend_Currency(
  61     array(
  62         'value'    => 1000.50,
  63         'currency' => 'USD',
  64     )
  65 );
  66
  67 print $currency; // Retournerait '$ 1.000,50'
  68 ]]></programlisting>
  69
  70         <para>
  71             Comme la précision est de 2, vous obtiendrez des décimales à '00' pour un chiffre rond.
  72         </para>
  73
  74         <programlisting language="php"><![CDATA[
  75 $currency = new Zend_Currency(
  76     array(
  77         'value'    => 1000,
  78         'currency' => 'USD',
  79     )
  80 );
  81
  82 print $currency; // Retournerait '$ 1.000,00'
  83 ]]></programlisting>
  84
  85         <para>
  86             Pour pallier à ce problème de précision, vous pouvez simplement utiliser l'option
  87             <property>precision</property> avec la valeur '0'. La précision prend une valeur entre
  88             0 et 9. Les valeurs des monnaies seront arrondies lorsqu'elles ne tiennent pas dans la
  89             précision demandée.
  90         </para>
  91
  92         <programlisting language="php"><![CDATA[
  93 $currency = new Zend_Currency(
  94     array(
  95         'value'     => 1000,30,
  96         'currency'  => 'USD',
  97         'precision' => 0
  98     )
  99 );
 100
 101 print $currency; // Retournerait '$ 1.000'
 102 ]]></programlisting>
 103     </sect2>
 104 </sect1>