4.0.1 • Published 2 years ago

@ionaru/format-number v4.0.1

Weekly downloads
2
License
MIT
Repository
github
Last release
2 years ago

@ionaru/format-number

npm version npm version Build Status codecov

Description

A package for formatting a number to improve its readability.

Usage

npm install @ionaru/format-number

Standard use

import { formatNumber } from 'format-number';
const formattedNumber = formatNumber(500.8);
console.log(formattedNumber);  // 500.80

No decimals

import { formatNumber } from 'format-number';
const formattedNumber = formatNumber(1.62, 0);
console.log(formattedNumber);  // 2

API

formatNumber(amount, decimalAmount, decimalMark, delimiter) ⇒ string

Format a number to make it more readable.

Kind: global function

ParamTypeDefaultDescription
amountnumber | stringThe amount that will be formatted, must be convertible by Number().
decimalAmountnumber2The amount of decimal places will be in the formatted number.
decimalMarkstring"."The character that marks the start the fractional part of the formatted number.
delimiterstring","The character that separates the thousands in a number.

Examples

Standard formatting is great for monetary values.

const formattedNumber = formatNumber(19499.99);
console.log(formattedNumber);  // 19,499.99

Show only whole numbers

const formattedNumber = formatNumber(19499.99, 0);
console.log(formattedNumber);  // 19,500

The input number can be a string

const formattedNumber = formatNumber('19499.99');
console.log(formattedNumber);  // 19,499.99

Change the default markings in the number for international use.

Canadian

const formattedNumber = formatNumber(19499.99, undefined, ',', ' ');
console.log(formattedNumber);  // 19 499,99

Dutch

const formattedNumber = formatNumber(19499.99, undefined, ',', '.');
console.log(formattedNumber);  // 19.499,99
5.0.1-5.0

2 years ago

4.0.2-2.0

3 years ago

4.0.1

3 years ago

3.0.2-34.0

3 years ago

3.0.2-35.0

3 years ago

3.0.2-25.0

4 years ago

3.0.1

4 years ago

3.0.1-21.0

4 years ago

3.0.0

4 years ago

3.0.1-17.0

4 years ago

2.0.1-12.0

5 years ago

2.0.0

5 years ago

1.0.2-10.0

5 years ago

1.0.2-5.0

5 years ago

1.0.1

5 years ago

1.0.1-2.0

5 years ago

1.0.0

5 years ago