Currency

BX.Currency library is used to format prices with accounting of current JS language.

Part of the Currency module (currency) .

The following code connects the library:

if (\Bitrix\Main\Loader::includeModule('currency'))
{
	CJSCore::Init(['currency']);
}

Function	Description	Available from version
BX.Currency.clean	Erases formats of all currencies.
BX.Currency.clearCurrency	Deletes a format (if available).
BX.Currency.currencyFormat	Format price.
BX.Currency.getCurrencyFormat	Returns currency format.
BX.Currency.loadCurrencyFormat	Asynchronous format upload.
BX.Currency.setCurrencies	Sets formats for several currencies at once.
BX.Currency.setCurrencyFormat	Sets a specific currency format.

Price formatting:

<script type="text/javascript">
var price = 141.56,
	currency = 'USD';

item.innerHTML = BX.Currency.currencyFormat(price, currency, true); // insert formatted price with display template applied
item2.innerHTML = BX.Currency.currencyFormat(price, currency, false); // insert formatted price without template

</script>
/*
Result
item contains string $141.56
item2 contains string 141.56 (without currency symbol and the rest of template features)
*/

Before returning the format, you must clearly define formats for the required currencies:

<?
$currencies = []; // get all the available currencies 
$currencyIterator = \Bitrix\Currency\CurrencyTable::getList([
	'select' => ['CURRENCY']
]);
while ($currency = $currencyIterator->fetch())
{
	$currencyFormat = \CCurrencyLang::GetFormatDescription($currency['CURRENCY']);
	$currencies[] = [
		'CURRENCY' => $currency['CURRENCY'],
		'FORMAT' => [
			'FORMAT_STRING' => $currencyFormat['FORMAT_STRING'],
			'DEC_POINT' => $currencyFormat['DEC_POINT'],
			'THOUSANDS_SEP' => $currencyFormat['THOUSANDS_SEP'],
			'DECIMALS' => $currencyFormat['DECIMALS'],
			'THOUSANDS_VARIANT' => $currencyFormat['THOUSANDS_VARIANT'],
			'HIDE_ZERO' => $currencyFormat['HIDE_ZERO']
		]
	];
}
?>
<script type="text/javascript">
BX.Currency.setCurrencies(<?=CUtil::PhpToJSObject($currencies, false, true, true);?>);
</script>

or asynchronously upload the currencies (currency 19.0.100module version and higher):

<script type="text/javascript">
BX.Currency.loadCurrencyFormat('USD').then(function() 
{
	item.innerHTML = BX.Currency.currencyFormat(123, 'USD', true);
});
</script>

When using the second method you must manage the upload process and not use the formatting method before data is uploaded successfully.

Format description (objet fields) almost completely match the data, returned by the method CCurrencyLang::GetFormatDescription (without the key THOUSANDS_VARIANT).