Aveta
Convert large numbers into concise, human-readable formats easily.
6000 | '6K' |
10000 | '10K' |
42500 | '42.5K' |
1250000 | '1.25M' |
Installation
With npm:
npm install aveta
With Yarn:
yarn add aveta
Usage
aveta(value: number, options?: Partial<IOptions>): string;
import aveta from 'aveta';
aveta(8700);
aveta(123456, {
digits: 3,
lowercase: true,
});
aveta(4567, {
digits: 3,
lowercase: true,
});
aveta(2048000, {
precision: 2,
lowercase: true,
});
aveta(45500, {
precision: 3,
separator: ',',
});
aveta(1440000, {
units: ['B', 'KB', 'MB', 'GB', 'TB'],
space: true,
});
AvetaReverse
Aveta also supports reversing the human-readable format back to a numeric value using the avetaReverse
function.
avetaReverse(value: string): number;
import { avetaReverse } from 'aveta';
avetaReverse('8.7K');
avetaReverse('123k');
avetaReverse('4.57k');
avetaReverse('2.48m');
Command Line Usage
You can also use aveta
directly in the terminal.
$ aveta 234000
$ npx aveta 234000
234K
For more options, run:
aveta --help
Default Options
Default Options
precision | number | 1 | Number of decimal places to round to |
digits | number | 0 | Number of significant digits to display |
separator | string | '.' | Decimal separator (e.g. . or , ) |
lowercase | boolean | false | Output unit abbreviations in lowercase |
space | boolean | false | Insert a space between the number and unit abbreviation |
units | Array<string> | ['', 'K', 'M', 'B', 'T', 'P', 'E'] | Units to use for thousand, million, billion, etc. |
base | number | 1000 | Base to scale numbers (default is 1000 for K, M, etc.) |
roundingMode | 'up' | 'down' | 'nearest' | 'nearest' | How numbers are rounded: nearest, always up, or always down |
threshold | number | 0 | Minimum value before unit conversion is applied (coming) |
License
Aveta is available under the MIT License.
Authors
Created by Mhammed Talhaouy.