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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.currency.value">
    <title>Travailler avec les valeurs des monnaies (les montants)</title>

    <para>
        Travailler avec des monnaies c'est avant tout travailler avec des valeurs, des "prix", un montant.
        Il faut ainsi travailler avec le montant (la valeur), la précision et l'éventuel taux de change.
    </para>

    <sect2 id="zend.currency.value.money">
        <title>Travailler avec les valeurs des monnaies</title>

        <para>
            La valeur de la monnaie (le montant) se précise grâce à l'option <property>value</property>.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value'    => 1000,
        'currency' => 'USD',
    )
);

print $currency; // Retournerait '$ 1.000'
]]></programlisting>

        <para>
            Vous pouvez changer la valeur en utilisant les méthodes <methodname>setFormat()</methodname>
            ou <methodname>setValue()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value'    => 1000,
        'currency' => 'USD',
    )
);

print $currency->setValue(2000); // Retournerait '$ 2.000'
]]></programlisting>

        <para>
            <methodname>getValue()</methodname> existe aussi.
        </para>
    </sect2>

    <sect2 id="zend.currency.value.precision">
        <title>Utiliser la précision des monnaies</title>

        <para>
            La plupart des monnaies utilisent une précision de 2, ce qui signifie qu'avec 100 dollars US
            vous pouvez rajouter 50 cents. C'est simplement le paramètre après la virgule.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value'    => 1000.50,
        'currency' => 'USD',
    )
);

print $currency; // Retournerait '$ 1.000,50'
]]></programlisting>

        <para>
            Comme la précision est de 2, vous obtiendrez des décimales à '00' pour un chiffre rond.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value'    => 1000,
        'currency' => 'USD',
    )
);

print $currency; // Retournerait '$ 1.000,00'
]]></programlisting>

        <para>
            Pour pallier à ce problème de précision, vous pouvez simplement utiliser l'option
            <property>precision</property> avec la valeur '0'. La précision prend une valeur entre
            0 et 9. Les valeurs des monnaies seront arrondies lorsqu'elles ne tiennent pas dans la
            précision demandée.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value'     => 1000,30,
        'currency'  => 'USD',
        'precision' => 0
    )
);

print $currency; // Retournerait '$ 1.000'
]]></programlisting>
    </sect2>
</sect1>