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

Add

bool
CCurrencyRates::Add(
 array arFields
);

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

Сбрасывает кеш currency_rate в случае успешного добавления, сбрасывает тэгированный кеш currency_id_КОД_ВАЛЮТЫ.

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

ПараметрОписание
arFields

Ассоциативный массив параметров курса валюты, ключами которого являются названия параметров, а значениями - значения параметров.

Допустимые ключи (Все поля обязательны):

  • CURRENCY - код валюты, для которой добавляется курс;
  • DATE_RATE - дата БЕЗ ВРЕМЕНИ, на которую устанавливается курс;
  • RATE_CNT - количество единиц валюты, которое участвует в задании курса валюты (например, если 10 Датских крон стоят 48.7 рублей, то 10 - это количество единиц);
  • RATE - курс валюты.

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

Возвращает значение ID курса валют в случае успешного добавления и False - в противном случае. Текст ошибки выводится с помощью $APPLICATION->GetException().

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

<?
// Считаем, что RUR - базовая валюта
// Курс ирландских крон (ISK) на 21.02.2005:  10 ISK = 48.1756 RUR

$arFields = array(
    "RATE" => 48.1756,
    "RATE_CNT" => 10,
    "CURRENCY" => "ISK",
    "DATE_RATE" => "21.02.2005"
    );

if (!CCurrencyRates::Add($arFields))
    echo "Ошибка добавления курса";
?>


© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх