Viacmenové súčty

MoneyBag je nemenný viacmenový akumulátor — peňaženka alebo košík, ktorý drží zostatky vo viacerých menách vedľa seba:

use RoundlyConsulting\Money\MoneyBag;

$bag = MoneyBag::of(Money::ofMajor('10', 'EUR'), Money::ofMajor('12', 'USD'))
    ->add(Money::ofMajor('100', 'CZK'))
    ->subtract(Money::ofMajor('2', 'USD'));

$bag->get('USD');         // 10.00 USD
$bag->get('GBP');         // 0.00 GBP — zero when absent
$bag->currencies();       // [CZK, EUR, USD] — sorted by code
$bag->all();              // list<Money>
$bag->isEmpty();          // false

$bag->total('EUR');                    // converted and summed exactly, rounded once
$bag->total('EUR', now()->subDay());   // with historical rates

• of() a add() zoskupujú sumy podľa kódu meny; subtract() funguje rovnako.
• get() vráti nulu pre menu, ktorú MoneyBag neobsahuje.
• currencies() a all() sú zoradené podľa kódu.
• isEmpty() — zostatky, ktoré sa vrátia na nulu, z MoneyBag vypadnú.
• Mena s rovnakým kódom, ale iným exponentom vyhodí CurrencyMismatch.

Súčty bez odchýlok

total($in, ?$on, ?$rounding) prevedie každý zostatok cez zaregistrovaného poskytovateľa kurzov a sčíta ich ako jeden presný zlomok, zaokrúhlený raz na konci (predvolene HalfEven) — žiadne odchýlky zo zaokrúhľovania po menách. Zadajte dátum, ak chcete historické kurzy.