Add

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

bool
CCurrencyRates::Add(
	array arFields
);

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

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

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

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

Параметр

Описание

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 "Ошибка добавления курса";
?>