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 - дата курса (выбираются записи с датами меньше указанной)

Параметр

Описание

Переменная , содержащая название поля для сортировки. Доступные названия:
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>";
}
?>

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

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

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

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

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

Александр Раковский 19.12.2014 12:14:55

получить курс валюты за определенную дату (за 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);

Наверх