#Форматирование валюты

#1. :formatC(precisionOrFormat, targetCurrency)

#Описание синтаксиса

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

• precisionOrFormat: Необязательный параметр, который может быть числом (указывающим количество десятичных знаков) или спецификатором формата:
  • Целое число: изменяет точность по умолчанию для десятичных знаков.
  • 'M': выводит только основное название валюты.
  • 'L': выводит число вместе с символом валюты (по умолчанию).
  • 'LL': выводит число вместе с основным названием валюты.
• targetCurrency: Необязательный параметр; код целевой валюты (в верхнем регистре, например, USD, EUR), который переопределяет глобальные настройки.

#Пример

// Пример окружения: параметры API { "lang": "en-us", "currency": { "source": "EUR", "target": "USD", "rates": { "EUR": 1, "USD": 2 } } }
'1000.456':formatC()      // Выводит "$2,000.91"
'1000.456':formatC('M')    // Выводит "dollars"
'1':formatC('M')           // Выводит "dollar"
'1000':formatC('L')        // Выводит "$2,000.00"
'1000':formatC('LL')       // Выводит "2,000.00 dollars"

// Пример для французского языка (при других настройках окружения):
'1000.456':formatC()      // Выводит "2 000,91 ..."  
'1000.456':formatC()      // Когда исходная и целевая валюты совпадают, выводит "1 000,46 €"

#Результат

Результат вывода зависит от параметров API и настроек обменного курса.

#2. :convCurr(target, source)

#Описание синтаксиса

Этот метод конвертирует число из одной валюты в другую. Обменный курс может быть передан через параметры API или установлен глобально. Если параметры не указаны, конвертация автоматически выполняется из options.currencySource в options.currencyTarget. Параметры:

• target: Необязательный параметр; код целевой валюты (по умолчанию равен options.currencyTarget).
• source: Необязательный параметр; код исходной валюты (по умолчанию равен options.currencySource).

#Пример

// Пример окружения: параметры API { "currency": { "source": "EUR", "target": "USD", "rates": { "EUR": 1, "USD": 2 } } }
10:convCurr()              // Выводит 20
1000:convCurr()            // Выводит 2000
1000:convCurr('EUR')        // Выводит 1000
1000:convCurr('USD')        // Выводит 2000
1000:convCurr('USD', 'USD') // Выводит 1000

#Результат

Результатом является конвертированное значение валюты.