Как округлять числа до ближайших 0,05 или другого шага в JavaScript

Введение

Клиент в Канаде добавляет товары в корзину на сумму $11.23, но итоговая сумма составляет $11.25. Это происходит потому, что Канада исключила из обращения монету в 1 цент в 2013 году, и наличные расчёты округляются до ближайших 0.05. Вашему приложению необходимо отображать цены, которые соответствуют фактическим расходам клиентов.

Округление до определённых интервалов решает эту проблему. Вы можете округлять числа до ближайших 0.05 (никель), 0.10 (дайм) или любого другого интервала. Это применимо к форматированию валют, системам измерений и любым другим сценариям, где значения должны соответствовать определённым интервалам.

В этом руководстве показано, как округлять числа до пользовательских интервалов с использованием JavaScript, включая как ручную реализацию, так и современный API Intl.NumberFormat.

Почему важно округлять до определённых интервалов

Многие страны исключили из обращения монеты мелкого номинала по практическим причинам. Производство и обработка таких монет обходятся дороже их номинальной стоимости. Наличные расчёты в этих странах округляются до ближайшей доступной монеты.

Страны, использующие округление до 0.05 для наличных платежей:

Канада (исключила монету в 1 цент в 2013 году)
Австралия (исключила монеты в 1 и 2 цента)
Нидерланды (округляют до ближайших 0.05 евро)
Бельгия (округляют до ближайших 0.05 евро)
Ирландия (округляют до ближайших 0.05 евро)
Италия (округляют до ближайших 0.05 евро)
Финляндия (округляют до ближайших 0.05 евро)
Швейцария (самая мелкая монета — 0.05 CHF)

Страны, использующие округление до 0.10:

Новая Зеландия (исключила монету в 5 центов в 2006 году)

США планируют прекратить производство монет в 1 цент к началу 2026 года, что потребует округления до 0.05 для наличных расчётов.

Округление наличных расчётов применяется только к итоговой сумме транзакции, а не к отдельным товарам. Электронные платежи остаются точными, так как физические монеты не используются.

Помимо валюты, вам могут понадобиться пользовательские интервалы для:

Систем измерений с определёнными требованиями к точности
Научных расчётов, округляемых до точности инструмента
Элементов управления пользовательского интерфейса, которые привязываются к определённым значениям
Ценовых стратегий, использующих психологические ценовые точки

Математическая концепция округления до приращения

Округление до приращения означает нахождение ближайшего кратного этого приращения. Формула делит число на приращение, округляет до ближайшего целого числа, а затем умножает обратно на приращение.

roundedValue = Math.round(value / increment) * increment

Например, округление 11.23 до ближайшего 0.05:

Деление: 11.23 / 0.05 = 224.6
Округление: Math.round(224.6) = 225
Умножение: 225 * 0.05 = 11.25

Деление преобразует приращение в целочисленные шаги. Округление 224.6 до 225 находит ближайший шаг. Умножение возвращает обратно к исходной шкале.

Для 11.27, округленного до ближайшего 0.05:

Деление: 11.27 / 0.05 = 225.4
Округление: Math.round(225.4) = 225
Умножение: 225 * 0.05 = 11.25

И 11.23, и 11.27 округляются до 11.25, так как они находятся в пределах 0.025 от этого значения. Средняя точка 11.25 остаётся 11.25.

Реализация округления до приращения вручную

Создайте функцию, которая округляет любое число до указанного приращения:

function roundToIncrement(value, increment) {
  return Math.round(value / increment) * increment;
}

console.log(roundToIncrement(11.23, 0.05)); // 11.25
console.log(roundToIncrement(11.27, 0.05)); // 11.25
console.log(roundToIncrement(11.28, 0.05)); // 11.30
console.log(roundToIncrement(4.94, 0.10)); // 4.90
console.log(roundToIncrement(4.96, 0.10)); // 5.00

Это работает для любого приращения, не только для валюты:

console.log(roundToIncrement(17, 5)); // 15
console.log(roundToIncrement(23, 5)); // 25
console.log(roundToIncrement(2.7, 0.5)); // 2.5

Арифметика с плавающей точкой в JavaScript может вводить небольшие ошибки точности. Для расчётов с валютой, где важна точность, умножайте значения на степень 10, чтобы работать с целыми числами:

function roundToIncrementPrecise(value, increment) {
  // Найти количество десятичных знаков в приращении
  const decimals = (increment.toString().split('.')[1] || '').length;
  const multiplier = Math.pow(10, decimals);

  // Преобразовать в целые числа
  const valueInt = Math.round(value * multiplier);
  const incrementInt = Math.round(increment * multiplier);

  // Округлить и преобразовать обратно
  return Math.round(valueInt / incrementInt) * incrementInt / multiplier;
}

console.log(roundToIncrementPrecise(11.23, 0.05)); // 11.25

Math.round() использует округление "до ближайшего вверх", где значения, находящиеся ровно на полпути между двумя приращениями, округляются вверх. Некоторые приложения требуют других режимов округления:

function roundToIncrementWithMode(value, increment, mode = 'halfUp') {
  const divided = value / increment;

  let rounded;
  switch (mode) {
    case 'up':
      rounded = Math.ceil(divided);
      break;
    case 'down':
      rounded = Math.floor(divided);
      break;
    case 'halfDown':
      rounded = divided % 1 === 0.5 ? Math.floor(divided) : Math.round(divided);
      break;
    case 'halfUp':
    default:
      rounded = Math.round(divided);
      break;
  }

  return rounded * increment;
}

console.log(roundToIncrementWithMode(11.225, 0.05, 'halfUp')); // 11.25
console.log(roundToIncrementWithMode(11.225, 0.05, 'halfDown')); // 11.20
console.log(roundToIncrementWithMode(11.23, 0.05, 'up')); // 11.25
console.log(roundToIncrementWithMode(11.23, 0.05, 'down')); // 11.20

Использование Intl.NumberFormat с roundingIncrement

Современные браузеры поддерживают опцию roundingIncrement в Intl.NumberFormat, которая автоматически обрабатывает округление до заданного шага при форматировании чисел.

Базовое использование для округления канадского доллара до никеля:

const formatter = new Intl.NumberFormat('en-CA', {
  style: 'currency',
  currency: 'CAD',
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
  roundingIncrement: 5
});

console.log(formatter.format(11.23)); // CA$11.25
console.log(formatter.format(11.27)); // CA$11.25
console.log(formatter.format(11.28)); // CA$11.30

Опция roundingIncrement принимает только определённые значения:

1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, 5000

Для округления до 0.05 установите maximumFractionDigits: 2 и roundingIncrement: 5. Для округления до 0.10 установите maximumFractionDigits: 1 и roundingIncrement: 1, либо оставьте maximumFractionDigits: 2 с roundingIncrement: 10.

Округление швейцарского франка до 0.05:

const chfFormatter = new Intl.NumberFormat('de-CH', {
  style: 'currency',
  currency: 'CHF',
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
  roundingIncrement: 5
});

console.log(chfFormatter.format(8.47)); // CHF 8.45
console.log(chfFormatter.format(8.48)); // CHF 8.50

Округление новозеландского доллара до 0.10:

const nzdFormatter = new Intl.NumberFormat('en-NZ', {
  style: 'currency',
  currency: 'NZD',
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
  roundingIncrement: 10
});

console.log(nzdFormatter.format(15.94)); // $15.90
console.log(nzdFormatter.format(15.96)); // $16.00

Вы можете комбинировать roundingIncrement с различными режимами округления:

const formatterUp = new Intl.NumberFormat('en-CA', {
  style: 'currency',
  currency: 'CAD',
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
  roundingIncrement: 5,
  roundingMode: 'ceil'
});

console.log(formatterUp.format(11.21)); // CA$11.25 (округлено вверх)

Доступные режимы округления:

ceil: округление в сторону положительной бесконечности
floor: округление в сторону отрицательной бесконечности
expand: округление от нуля
trunc: округление к нулю
halfCeil: округление половины в сторону положительной бесконечности
halfFloor: округление половины в сторону отрицательной бесконечности
halfExpand: округление половины от нуля (по умолчанию)
halfTrunc: округление половины к нулю
halfEven: округление половины до чётного числа (банковское округление)

Важные ограничения для roundingIncrement:

Значения minimumFractionDigits и maximumFractionDigits должны быть одинаковыми
Нельзя комбинировать с округлением по значимым цифрам
Работает только при roundingPriority равном auto (по умолчанию)

Проверьте, поддерживает ли браузер roundingIncrement:

function supportsRoundingIncrement() {
  try {
    const formatter = new Intl.NumberFormat('en-US', {
      roundingIncrement: 5,
      minimumFractionDigits: 2,
      maximumFractionDigits: 2
    });
    const options = formatter.resolvedOptions();
    return options.roundingIncrement === 5;
  } catch (e) {
    return false;
  }
}

if (supportsRoundingIncrement()) {
  // Используйте Intl.NumberFormat с roundingIncrement
} else {
  // Используйте ручное округление
}

Примеры практической реализации

Создайте форматтер валюты, который обрабатывает округление наличных средств в зависимости от локали:

function createCashFormatter(locale, currency) {
  // Определите правила округления наличных средств по валюте
  const cashRoundingRules = {
    'CAD': { increment: 5, digits: 2 },
    'AUD': { increment: 5, digits: 2 },
    'EUR': { increment: 5, digits: 2 }, // Некоторые страны еврозоны
    'CHF': { increment: 5, digits: 2 },
    'NZD': { increment: 10, digits: 2 }
  };

  const rule = cashRoundingRules[currency];

  if (!rule) {
    // Специальное округление не требуется
    return new Intl.NumberFormat(locale, {
      style: 'currency',
      currency: currency
    });
  }

  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: currency,
    minimumFractionDigits: rule.digits,
    maximumFractionDigits: rule.digits,
    roundingIncrement: rule.increment
  });
}

const cadFormatter = createCashFormatter('en-CA', 'CAD');
console.log(cadFormatter.format(47.83)); // CA$47.85

const usdFormatter = createCashFormatter('en-US', 'USD');
console.log(usdFormatter.format(47.83)); // $47.83 (без округления)

Обрабатывайте как наличные, так и безналичные платежи:

function formatPaymentAmount(amount, currency, locale, paymentMethod) {
  if (paymentMethod === 'cash') {
    const formatter = createCashFormatter(locale, currency);
    return formatter.format(amount);
  } else {
    // Электронные платежи используют точные суммы
    return new Intl.NumberFormat(locale, {
      style: 'currency',
      currency: currency
    }).format(amount);
  }
}

console.log(formatPaymentAmount(11.23, 'CAD', 'en-CA', 'cash')); // CA$11.25
console.log(formatPaymentAmount(11.23, 'CAD', 'en-CA', 'card')); // CA$11.23

Рассчитайте фактическую сумму для оплаты:

function calculateCashTotal(items, currency) {
  const subtotal = items.reduce((sum, item) => sum + item.price, 0);

  // Применяйте округление наличных только к итоговой сумме
  const cashRoundingRules = {
    'CAD': 0.05,
    'AUD': 0.05,
    'CHF': 0.05,
    'NZD': 0.10
  };

  const increment = cashRoundingRules[currency];

  if (!increment) {
    return subtotal;
  }

  return roundToIncrement(subtotal, increment);
}

function roundToIncrement(value, increment) {
  return Math.round(value / increment) * increment;
}

const items = [
  { price: 5.99 },
  { price: 3.49 },
  { price: 1.75 }
];

console.log(calculateCashTotal(items, 'CAD')); // 11.25
console.log(calculateCashTotal(items, 'USD')); // 11.23

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

// Отображение температуры, округленной до ближайших 0,5 градусов
function formatTemperature(celsius) {
  const rounded = roundToIncrement(celsius, 0.5);
  return new Intl.NumberFormat('en-US', {
    style: 'unit',
    unit: 'celsius',
    minimumFractionDigits: 1,
    maximumFractionDigits: 1
  }).format(rounded);
}

console.log(formatTemperature(22.3)); // 22.5°C
console.log(formatTemperature(22.6)); // 22.5°C

// Значения ползунка, привязанные к инкрементам
function snapToGrid(value, gridSize) {
  return roundToIncrement(value, gridSize);
}

console.log(snapToGrid(47, 5)); // 45
console.log(snapToGrid(53, 5)); // 55

Важные соображения и крайние случаи

Применяйте округление наличных только к итоговой сумме транзакции, а не к отдельным позициям. Округление каждой позиции отдельно дает другой результат, чем округление суммы:

const items = [1.23, 1.23, 1.23];

// Неправильно: округление каждой позиции
const wrongTotal = items
  .map(price => roundToIncrement(price, 0.05))
  .reduce((sum, price) => sum + price, 0);
console.log(wrongTotal); // 3.75

// Правильно: округление итоговой суммы
const correctTotal = roundToIncrement(
  items.reduce((sum, price) => sum + price, 0),
  0.05
);
console.log(correctTotal); // 3.70

Отображайте округленные суммы пользователям, но сохраняйте точные суммы в вашей базе данных. Это сохраняет точность для бухгалтерского учета и позволяет изменять правила округления без потери информации:

const transaction = {
  items: [
    { id: 1, price: 5.99 },
    { id: 2, price: 3.49 },
    { id: 3, price: 1.75 }
  ],
  subtotal: 11.23, // Сохранить точное значение
  currency: 'CAD',
  paymentMethod: 'cash'
};

// Рассчитать отображаемую сумму
const displayAmount = roundToIncrement(transaction.subtotal, 0.05); // 11.25

Разные страны, использующие одну и ту же валюту, могут иметь разные правила округления наличных. Евро используется в странах с округлением наличных и без него. Проверяйте правила конкретной страны, а не только валюту.

Отрицательные суммы округляются к нулю для абсолютного значения, затем применяется отрицательный знак:

console.log(roundToIncrement(-11.23, 0.05)); // -11.25
console.log(roundToIncrement(-11.22, 0.05)); // -11.20

Очень большие числа могут терять точность при использовании арифметики с плавающей точкой. Для финансовых приложений, работающих с большими суммами, рассмотрите использование целочисленной арифметики с наименьшей денежной единицей:

function roundToIncrementCents(cents, incrementCents) {
  return Math.round(cents / incrementCents) * incrementCents;
}

// Работа в центах
const amountCents = 1123; // $11.23
const roundedCents = roundToIncrementCents(amountCents, 5); // 1125
const dollars = roundedCents / 100; // 11.25

Тестируйте реализацию округления на крайних случаях:

// Тестовые случаи для округления 0.05
const testCases = [
  { input: 0.00, expected: 0.00 },
  { input: 0.01, expected: 0.00 },
  { input: 0.02, expected: 0.00 },
  { input: 0.025, expected: 0.05 },
  { input: 0.03, expected: 0.05 },
  { input: 0.99, expected: 1.00 },
  { input: -0.03, expected: -0.05 },
  { input: 11.225, expected: 11.25 }
];

testCases.forEach(({ input, expected }) => {
  const result = roundToIncrement(input, 0.05);
  console.log(`${input} -> ${result} (expected ${expected})`);
});

Опция roundingIncrement в Intl.NumberFormat поддерживается в современных браузерах. Firefox добавил поддержку в версии 93. Для приложений, поддерживающих старые браузеры, реализуйте резервный вариант:

function formatCurrency(amount, locale, currency, increment) {
  try {
    const formatter = new Intl.NumberFormat(locale, {
      style: 'currency',
      currency: currency,
      minimumFractionDigits: 2,
      maximumFractionDigits: 2,
      roundingIncrement: increment
    });

    // Проверить, была ли применена roundingIncrement
    if (formatter.resolvedOptions().roundingIncrement === increment) {
      return formatter.format(amount);
    }
  } catch (e) {
    // roundingIncrement не поддерживается
  }

  // Резервный вариант: ручное округление
  const rounded = roundToIncrement(amount, increment / 100);
  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: currency
  }).format(rounded);
}

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

<div class="cart-summary">
  <div class="line-item">Промежуточный итог: $11.23</div>
  <div class="line-item total">Итог (наличные): $11.25</div>
  <div class="note">Наличные платежи округляются до ближайших $0.05</div>
</div>

Разные юрисдикции имеют разные правила о том, кто выигрывает от округления (клиент или продавец) и как обрабатывать крайние случаи. Обратитесь к местным правилам для вашего конкретного случая.