Форматирование чисел в строку с валютой на JavaScript: лучшие способы

Использование Intl.NumberFormat — нативный и гибкий способ

Лучший способ форматирования чисел как строк с валютой в современном JavaScript — использовать объект Intl.NumberFormat. Этот встроенный API поддерживает все основные валюты мира, учитывает правила форматирования для разных локалей (пробелы, разделители разрядов, положение знака валюты) и не требует сторонних библиотек.

Базовое использование

Для создания форматтера вызовите конструктор с локалью (например, 'ru-RU' для России или 'en-US' для США) и опциями:

const formatter = new Intl.NumberFormat('ru-RU', {
  style: 'currency',
  currency: 'RUB'
});

console.log(formatter.format(1234.56)); // "1 234,56 ₽"
console.log(formatter.format(1000000)); // "1 000 000,00 ₽"

Как это работает

Параметры в опциях:

• style: 'currency' — включает режим форматирования валюты.
• currency: 'RUB' — код валюты по стандарту ISO 4217 (например, 'USD', 'EUR', 'GBP').
• По умолчанию количество десятичных знаков определяется валютой (для RUB — 2, для JPY — 0).

Пример с долларами США

const usFormatter = new Intl.NumberFormat('en-US', {
  style: 'currency',
  currency: 'USD'
});

console.log(usFormatter.format(1234.56)); // "$1,234.56"
console.log(usFormatter.format(0.99));    // "$0.99"

Настройка количества знаков после запятой

Вы можете явно указать минимальное и максимальное количество десятичных знаков:

const formatter = new Intl.NumberFormat('ru-RU', {
  style: 'currency',
  currency: 'RUB',
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});

console.log(formatter.format(100)); // "100,00 ₽" (а не "100,00 ₽")

Работа с большими числами и округление

Intl.NumberFormat автоматически округляет числа по математическим правилам:

const formatter = new Intl.NumberFormat('ru-RU', {
  style: 'currency',
  currency: 'RUB'
});

console.log(formatter.format(1234.5678)); // "1 234,57 ₽" (округление до 2 знаков)

Обработка ошибок: если передана неверная валюта

Если код валюты некорректен, Intl.NumberFormat выдаст ошибку RangeError. Рекомендуется оборачивать вызов в try-catch или проверять код валюты:

function safeFormatCurrency(amount, currencyCode) {
  try {
    const formatter = new Intl.NumberFormat('ru-RU', {
      style: 'currency',
      currency: currencyCode.toUpperCase()
    });
    return formatter.format(amount);
  } catch (e) {
    console.error('Неверный код валюты:', currencyCode);
    return amount.toString(); // fallback
  }
}

console.log(safeFormatCurrency(100, 'usd')); // "100,00 $"
console.log(safeFormatCurrency(100, 'XYZ')); // "100" + ошибка в консоли

Полный пример для интернет-магазина

const prices = [
  { amount: 1299.99, currency: 'USD' },
  { amount: 4500, currency: 'RUB' },
  { amount: 89.95, currency: 'EUR' }
];

function formatPrice(amount, currency, locale = 'ru-RU') {
  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: currency
  }).format(amount);
}

prices.forEach(item => {
  console.log(formatPrice(item.amount, item.currency));
  // Вывод:
  // "1 299,99 $" (для USD в русской локали)
  // "4 500,00 ₽"
  // "89,95 €"
});

Важные замечания

• Локаль влияет на формат: в 'en-US' разделитель тысяч — запятая, десятичный — точка; в 'ru-RU' — наоборот.
• Положение знака валюты также зависит от локали: для 'en-US' знак перед числом ($10), для 'ru-RU' — после (10 ₽).
• Этот метод работает во всех современных браузерах и Node.js (начиная с версии 0.12).

const price = 1234567.89;
console.log(price.toLocaleString('ru-RU', {
  style: 'currency',
  currency: 'RUB'
})); // "1 234 567,89 ₽"

function formatCurrency(amount, currency, locale = 'ru-RU') {
  return amount.toLocaleString(locale, {
    style: 'currency',
    currency: currency
  });
}

console.log(formatCurrency(99.99, 'USD')); // "99,99 $"
console.log(formatCurrency(99.99, 'EUR', 'de-DE')); // "99,99 €" (немецкая локаль)