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

GetList

CDBResult
CCurrencyRates::GetList(
 string &by, 
 string &order, 
 array arFilter = Array()
);

Метод возвращает список курсов валют, удовлетворяющих фильтру arFilter, отсортированный по полю by в направлении order. Метод статический.

Параметры вызова

ПараметрОписание
by Переменная , содержащая название поля для сортировки. Доступные названия:
date - дата курса (по умолчанию)
curr - валюта
rate - курс.
order Переменная, содержащая направление сортировки. Допустимы значения:
asc - по возрастанию (по умолчанию)
desc - по убыванию.
arFilter

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

Допустимые поля для фильтра:
CURRENCY - код валюты
DATE_RATE - дата курса (выбираются записи с датами больше или равными указанной)
!DATE_RATE - дата курса (выбираются записи с датами меньше указанной)

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

Объект класса CDBResult, содержащий записи с ключами

Ключ Описание
ID Код курса.
CURRENCY Код валюты.
DATE_RATE Дата, за которую установлен курс.
RATE_CNT количество единиц валюты, которое участвует в задании курса валюты (например, если 10 Датских крон стоят 48.7 рублей, то 10 - это количество единиц)
RATE курс валюты (одна из валют сайта должна иметь курс "по-умолчанию" 1, она называется базовой, остальные валюты имеют курс относительно базовой валюты)

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


<?
// Выведем все курсы USD, отсортированные по дате
$arFilter = array(
    "CURRENCY" => "USD"
    );
$by = "date";
$order = "desc";

$db_rate = CCurrencyRates::GetList($by, $order, $arFilter);
while($ar_rate = $db_rate->Fetch())
{
    echo $ar_rate["RATE"]."<br>";
}
?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
1
Александр Раковский
получить курс валюты за определенную дату (за 16.12.2014)
Код
CModule::IncludeModule("currency");

$arFilter = array(
    "CURRENCY" => "USD", 
    'DATE_RATE' => '16.12.2014',
    '!DATE_RATE' => '17.12.2014',
    );
$by = "date";
$order = "desc";

$row = CCurrencyRates::GetList($by, $order, $arFilter)->Fetch();
var_dump($row);
 

получить курс валюты за любую дату, менее указанной (за 16.12.2014 или 15дек, 14дек ... какая ближайшая существует)

Код
CModule::IncludeModule("currency");

$arFilter = array(
    "CURRENCY" => "USD", 
    '!DATE_RATE' => '17.12.2014',
    );
$by = "date";
$order = "desc";

$row = CCurrencyRates::GetList($by, $order, $arFilter)->Fetch();
var_dump($row);
  
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх