bdd-number-format

A TypeScript utility package for formatting numbers with various options, including large numbers, currencies, decimals, and percentages. This package uses the Indonesian ('en-ID') locale for number formatting.

Installation

npm install bdd-number-format

Features

• Format large numbers with K/M/B/T suffixes
• Format currency values
• Format floating-point numbers with custom decimal places
• Format integers
• Format percentages

Usage

import { fmtBig, fmtCur, fmtFlt, fmtInt, fmtPct } from 'bdd-number-format';

// Format large numbers
console.log(fmtBig(1234567));         // "1.2M"
console.log(fmtBig(1234567, 2));      // "1.23M"
console.log(fmtBig(1234567, 1, "$")); // "$ 1.2M"
console.log(fmtBig(1234, 0, "", "users")); // "1.2K users"

// Format currency
console.log(fmtCur(1234567, "IDR"));  // "IDR 1,234,567"
console.log(fmtCur(1234567.89, "USD", 2)); // "USD 1,234,567.89"

// Format floating point numbers
console.log(fmtFlt(1234.5678));     // "1,234.57"
console.log(fmtFlt(1234.5678, 3));  // "1,234.568"

// Format integers
console.log(fmtInt(1234.56));       // "1235"

// Format percentages
console.log(fmtPct(0.1234));        // "0.12%"
console.log(fmtPct(0.1234, 1));     // "0.1%"

API Reference

fmtBig(value: number, decimals?: number, prefix?: string, suffix?: string)

Formats large numbers with K/M/B/T suffixes.

• value: The number to format
• decimals: Number of decimal places (default: 0)
• prefix: Optional prefix to add before the number
• suffix: Optional suffix to add after the number

fmtCur(value: number, currency: string, decimals?: number)

Formats numbers as currency.

• value: The number to format
• currency: Currency code (e.g., "USD", "IDR")
• decimals: Number of decimal places (default: 0)

fmtFlt(value: number, decimals?: number)

Formats floating-point numbers.

• value: The number to format
• decimals: Number of decimal places (default: 2)

fmtInt(value: number)

Formats numbers as rounded integers.

• value: The number to format

fmtPct(value: number, decimals?: number)

Formats numbers as percentages.

• value: The number to format (e.g., 0.1234 for 12.34%)
• decimals: Number of decimal places (default: 2)

License

MIT © bdd-wisnu