#Форматування валюти

#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

#Результат

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