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

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-2024, «1С-Битрикс», 2024
Наверх