Документация для разработчиков
Темная тема

GetFormatDescription

Описание и параметры

array
CCurrencyLang::GetCurrencyFormat(
	string currency
);

Метод позволяет получить формат валюты на текущем языке для форматирования цен.

Проверяет наличие всех необходимых ключей: если каких-либо ключей нет, то устанавливает их значения по умолчанию.

Проверяет, в рамках какой части сайта вызван метод: если административной части продуктов «1С-Битрикс: Управление сайтом» или «Битрикс24», то формат валюты приводится к html-безопасному виду (вырезаются html-теги и java-скрипты).

Параметры метода

Параметр Описание
currency Код валюты, языкозависимые параметры которой нужны.

Возвращаемые значения

Ассоциативный массив с ключами:

Ключ Описание
FORMAT_STRING Строка формата, в соответствии с которой выводится суммы в этой валюте на этом языке.
DEC_POINT Символ, являющийся десятичной точкой при выводе сумм.
THOUSANDS_SEP Разделитель тысяч при выводе.
THOUSANDS_SEP Разделитель тысяч при выводе.
THOUSANDS_VARIANT Предустановленный вариант разделителя тысяч или признак, что разделитель кастомизированный.
DECIMALS Количество знаков после запятой при выводе.
HIDE_ZERO (Y|N) Определяет скрывать или показывать незначащие нули в дробной части (результат будет виден только в публичной части).

Пример использования

\Bitrix\Main\Loader::includeModule('currency');
$format = \CCurrencyLang::GetFormatDescription('RUB');
$value = 121.15;
$result = \CCurrencyLang::formatValue($value, $format);



© «Битрикс», 2001-2024, «1С-Битрикс», 2024