Zend_Currency-Calculation.xml 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 24249 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.currency.calculation">
  5. <title>Rechnen mit Währungen</title>
  6. <para>
  7. Wenn man mit Währungen arbeitet muss man manchmal mit Ihnen kalkulieren.
  8. <classname>Zend_Currency</classname> erlaubt das mit einigen einfachen Methoden. Die
  9. folgenden Methoden sind zur Unterstützung von Berechnungen:
  10. </para>
  11. <itemizedlist mark='opencircle'>
  12. <listitem>
  13. <para>
  14. <emphasis><methodname>add()</methodname></emphasis>: Diese Methode addiert die
  15. angegebene Währung zum existierenden Währungsobjekt.
  16. </para>
  17. </listitem>
  18. <listitem>
  19. <para>
  20. <emphasis><methodname>sub()</methodname></emphasis>: Diese Methode substrahiert
  21. die angegebene Währung vom existierenden Währungsobjekt.
  22. </para>
  23. </listitem>
  24. <listitem>
  25. <para>
  26. <emphasis><methodname>div()</methodname></emphasis>: Diese Methode dividiert die
  27. angegebene Währung vom existierenden Währungsobjekt.
  28. </para>
  29. </listitem>
  30. <listitem>
  31. <para>
  32. <emphasis><methodname>mul()</methodname></emphasis>: Diese Methode multipliziert
  33. die angegebene Währung zum existierenden Währungsobjekt.
  34. </para>
  35. </listitem>
  36. <listitem>
  37. <para>
  38. <emphasis><methodname>mod()</methodname></emphasis>: Diese Methode berechnet den
  39. verbleibenden Wert (Modulo) einer Division der angegebenen Währung vom existierenden
  40. Währungsobjekt.
  41. </para>
  42. </listitem>
  43. <listitem>
  44. <para>
  45. <emphasis><methodname>compare()</methodname></emphasis>: Diese Methode vergleicht
  46. die angegebene Währung mit dem existierenden Währungsobjekt. Wenn beide Werte
  47. identisch sind wird '0' zurückgegeben. Wenn der existierende Währungswert größer als
  48. der angegebene ist gibt diese Methode 1 zurück. Andernfalls wird '-1' zurückgegeben.
  49. </para>
  50. </listitem>
  51. <listitem>
  52. <para>
  53. <emphasis><methodname>equals()</methodname></emphasis>: Diese Methode vergleicht
  54. die angegebene Währung mit dem existierenden Währungsobjekt. Wenn beide Werte
  55. identisch sind wird <constant>TRUE</constant> zurückgegeben, andernfalls
  56. <constant>FALSE</constant>.
  57. </para>
  58. </listitem>
  59. <listitem>
  60. <para>
  61. <emphasis><methodname>isMore()</methodname></emphasis>: Diese Methode vergleicht
  62. die angegebene Währung mit dem existierenden Währungsobjekt. Wenn die existierende
  63. Währung größer als die angegebene ist wird <constant>TRUE</constant> zurückgegeben,
  64. andernfalls <constant>FALSE</constant>.
  65. </para>
  66. </listitem>
  67. <listitem>
  68. <para>
  69. <emphasis><methodname>isLess()</methodname></emphasis>: Diese Methode vergleicht
  70. die angegebene Währung mit dem existierenden Währungsobjekt. Wenn die existierende
  71. Währung kleiner als die angegebene ist wird <constant>TRUE</constant> zurückgegeben,
  72. andernfalls <constant>FALSE</constant>.
  73. </para>
  74. </listitem>
  75. </itemizedlist>
  76. <para>
  77. Wie man sehen kann erlauben die verschiedenen Methoden mit
  78. <classname>Zend_Currency</classname> jede Art der Berechnung. Die nächsten Schnipsel zeigen
  79. einige Beispiele:
  80. </para>
  81. <programlisting language="php"><![CDATA[
  82. $currency = new Zend_Currency(
  83. array(
  84. 'value' => 1000,
  85. 'currency' => 'USD',
  86. )
  87. );
  88. print $currency; // Könnte '$ 1.000,00' zurückgeben
  89. $currency->add(500);
  90. print $currency; // Könnte '$ 1.500,00' zurückgeben
  91. ]]></programlisting>
  92. <programlisting language="php"><![CDATA[
  93. $currency_2 = new Zend_Currency(
  94. array(
  95. 'value' => 500,
  96. 'currency' => 'USD',
  97. )
  98. );
  99. if ($currency->isMore($currency_2)) {
  100. print "First is more";
  101. }
  102. $currency->div(5);
  103. print $currency; // Könnte '$ 200,00' zurückgeben
  104. ]]></programlisting>
  105. </sect1>