GetList

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

CDBResult
CCurrency::GetList(
	string &by, 
	string &order, 
	string lang = LANGUAGE_ID
);

Метод возвращает список валют, отсортированный по полю из параметра by в направлении order. Языкозависимые параметры валют берутся для языка, указанного в параметре lang (по умолчанию равен текущему языку). Нестатический метод.

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

Параметр	Описание
by	Переменная, содержащая порядок сортировки валют. Допустимые значения переменной: currency - код валюты name - название валюты на языке lang sort - индекс сортировки (по-умолчанию)
order	Переменная, содержащая направление сортировки. Допустимые значения: asc - по возрастанию значений (по-умолчанию) desc - по убыванию значений.
lang	Код языка, для которого выбираются языкозависимые параметры валют. Необязательный параметр.

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

Возвращается объект класса CDBResult, каждая запись в котором представляет собой массив с ключами:

Ключ	Описание
CURRENCY	Код валюты (трехсимвольный)
AMOUNT_CNT	Количество единиц валюты по-умолчанию, которое учавствует в задании курса валюты (например, если 10 Датских крон стоят 48.7 рублей, то 10 - это количество единиц)
AMOUNT	Курс валюты по-умолчанию (одна из валют сайта должна иметь курс 1, она называется базовой, остальные валюты имеют курс относительно базовой валюты)
SORT	Порядок сортировки.
DATE_UPDATE	Дата последнего изменения записи (в формате базы данных).
BASE	Флаг (Y/N) является ли валюта базовой.
NUMCODE	Трехзначный цифровой код валюты.
CREATED_BY	ID пользователя, добавившего валюту.
MODIFIED_BY	ID последнего пользователя, изменившего валюту.
DATE_UPDATE_FORMAT	Отформатированная в соответствии с настройками сайта дата последнего изменения записи.
LID	Код языка.
FORMAT_STRING	Строка формата для показа сумм в этой валюте.
FULL_NAME	Полное название валюты.
DEC_POINT	Символ, который используется при показе сумм в этой валюте для отображения десятичной точки.
THOUSANDS_SEP	Символ, который используется при показе сумм в этой валюте для отображения разделителя тысяч.
DECIMALS	Количество знаков после запятой при показе.
HIDE_ZERO	Флаг (Y/N) убирает показ в публичной части незначащих нулей у дробной части цены.

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

<?
// Выведем список валют на текущем языке, отсортированный по названию
// Кроме того выведем сумму 11.95 в формате этой валюты на текущем языке
$lcur = CCurrency::GetList(($by="name"), ($order="asc"), LANGUAGE_ID);
while($lcur_res = $lcur->Fetch())
{
	echo "[".$lcur_res["CURRENCY"]."] ".$lcur_res["FULL_NAME"].": ";
	echo CurrencyFormat(11.95, $lcur_res["CURRENCY"])."<br>";
}
?>

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

0 Андрей Чурсин 19.04.2024 17:21:28 Сообщение не промодерировано, возможны ошибки и неточности.
deprecated! use: $rsCurrency = \Bitrix\Currency\CurrencyLangTable::getList()->fetchAll();

Наверх