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

ConvertCurrency

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

float
CCurrencyRates::ConvertCurrency(
	float valSum,
	string curFrom,
	string curTo,
	string valDate = ""
);

Метод переводит сумму valSum из валюты curFrom в валюту curTo по курсу, установленному на дату valDate. Метод статический.

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

ПараметрОписание
valSum Сумма в валюте curFrom, которую нужно перевести в валюту curTo
curFrom Исходная валюта.
curTo Конечная валюта.
valDate Дата, по курсу на которую нужно осуществить перевод. Если дата пуста, то перевод идет по текущему курсу. Необязательный параметр.

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

Сумма в новой валюте

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

<?
// предполагаем, что валюты USD и EUR существуют в базе
$val = 11.95; // сумма в USD
$newval = CCurrencyRates::ConvertCurrency($val, "USD", "EUR");
echo $val." USD = ".$newval." EUR";
?>
<?
// способ конвертации валюты для списка
if (CModule::IncludeModule('currency')) {
	$factor = CCurrencyRates::GetConvertFactor('UEE', 'RUB');
} else {
	$factor = 1;
}

foreach ($arResult['ITEMS'] as $i => &$arItem) {
	$arItem['PROPERTY_PRICE_VALUE'] = number_format($arItem['PROPERTY_PRICE_VALUE'] * $factor, 0, '.', ' ');
}
?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
2
Logic
Аналогично функции CCurrencyRates::GetConvertFactor, дата должна быть указана в формате YYYY-MM-DD, а не в формате сайта.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх