commerceguys/intl

Releases

1. ▸▾v2.1.023 Sept 2026

   Adds Currency::getDisplayFractionDigits() , separate from Currency::getFractionDigits() :

   Adds Currency::getDisplayFractionDigits(), separate from Currency::getFractionDigits():

   • getFractionDigits(): the ISO 4217 minor units, used for rounding and converting amounts to minor units (e.g. for payment gateways).
   • getDisplayFractionDigits(): the CLDR display digits, used by CurrencyFormatter as the default number of decimals. Falls back to getFractionDigits() when not set.

   This restores the CLDR display digits that v2.0.10 replaced. COP, HUF, IDR, PKR, AFN, ALL, IQD, IRR, KPW, LAK, LBP, MGA, MMK, SOS, SYP and YER are formatted without their unused minor unit again (e.g. 9 505 Ft), while their fraction digits stay ISO 4217. Pass minimum_fraction_digits / maximum_fraction_digits to override.

   Currency objects created without display_fraction_digits (e.g. by custom currency repositories) keep their current formatting.

   Open source →
2. ▸▾v2.0.1023 Sept 2026

   Currency fraction digits now come from ISO 4217 instead of CLDR.

   Currency fraction digits now come from ISO 4217 instead of CLDR.

   CLDR 48 (shipped in v2.0.8) changed the fraction digits of COP, HUF, IDR and PKR from 2 to 0. Consumers such as Drupal Commerce use these digits to convert amounts to payment gateway minor units, so payments in those currencies were sent at 1/100 of the amount (see https://www.drupal.org/project/commerce/issues/3625166).

   Fraction digit changes:

   • COP, HUF, IDR, PKR: back to 2 (as in v2.0.7).
   • AFN, ALL, IRR, KPW, LAK, LBP, MGA, MMK, SOS, SYP, YER: 0 → 2, and IQD: 0 → 3, to match ISO 4217.

   The default number of decimals shown by CurrencyFormatter follows these values, so HUF is formatted with 2 decimals again. Pass maximum_fraction_digits to override.

   No other data changes.