README.md

💯 Percent round

Take an array of numeric values and returns an array with corresponding rounded percentages. The total of the returned values will always be 100.

Works in browsers and nodeJS. Also, available as an ES module.

Zero Dependency

Description

percentRound(percents, precision = 0)

• input - Number[]

  An array of numbers that will be turned to percents.

• precision - Number (default = 0)

  The number of digits to appear after the decimal point.

Usage

import percentRound from "percent-round";

percentRound([10.34, 20.043, 30.04, 39.567]);     // [10,    20,    30,    40]
percentRound([10.34, 20.043, 30.04, 39.567], 1);  // [10.3,  20.1,  30,    39.6]
percentRound([10.34, 20.043, 30.04, 39.567], 2);  // [10.34, 20.05, 30.04, 39.57]
percentRound([1, 2, 3, 4]);  // [10, 20, 30, 40]
percentRound([60, 60]);  // [50, 50]

Changelogs

• 2.3.1
  • Fix results sometimes containing negative numbers #9
• 2.3.0
  • Fix float rounding errors #3 (more about float rounding error)
• 2.2.1
  • Fix IE not supporting default arguments #6
• 2.2.0
  • Input numbers are automatically turned to percents
• 2.1.1
  • fix wrong file version headers when publishing
• 2.1.0
  • add typescript declaration
  • add ES6 module support
  • add minified library distribution file
  • add MIT Licensing
  • add changelog
  • add Travis CI
• 2.0.0
  • add float precision argument feature
  • performance improve
  • new rounding algorithm = better performance and accuracy
  • add test suite
  • fix wrong global UMD module naming #2
  • fix error when input percents are strings #1

License

MIT. See LICENSE file for details.