anyamount

Tiny human-readable number formatter built on native Intl.
Turn numbers into "1.2M", "€1,999.00", "3.2 GB", or "120 km/h".

▸ live demo

---

One function. Smart defaults. Any locale. ~0.7kb gzip. Zero dependencies.

Intl.NumberFormat is powerful. anyamount makes it usable.

Built for dashboards, feeds, pricing pages, file lists, and stats — anywhere a raw number should read like a person wrote it. No locale files. No plugins. No config.

import { anyamount } from "anyamount";

anyamount(1234567);
// "1.2M"  — smart mode (default)

anyamount(42);
// "42"

anyamount(1999, { mode: "currency", currency: "EUR" });
// "€1,999.00"

anyamount(3.2, { mode: "unit", unit: "gigabyte" });
// "3.2 GB"

anyamount(120, { mode: "unit", unit: "kilometer-per-hour", locale: "ru" });
// "120 км/ч"

---

install

npm install anyamount

---

usage

anyamount(value);
anyamount(value, options);

value is a number or a bigint — every mode accepts both. ±Infinity formats as the locale's infinity symbol ("∞"); NaN throws.

anyamount(1234567);
anyamount(0.1234);
anyamount(-42.5);
anyamount(123456789012345678901n);   // beyond MAX_SAFE_INTEGER, no precision loss

---

modes

The mode option picks the rendering strategy. Default is "smart".

smart

Context-aware. Compact notation for big numbers, plain formatting for small ones — the cutoff is |value| >= 10000.

anyamount(1234567, { locale: "en" });   // "1.2M"
anyamount(10000, { locale: "en" });     // "10K"
anyamount(9999, { locale: "en" });      // "9,999"
anyamount(42, { locale: "en" });        // "42"
anyamount(0.1234, { locale: "en" });    // "0.12"

anyamount(1234567, { locale: "en", style: "long" });
// "1.2 million"

anyamount(1234567, { locale: "en", digits: 2 });
// "1.23M"

Fraction digits default to 2 for plain numbers and 1 for compact ones.

Reads: locale, style, digits.

currency

Money via the Intl.NumberFormat currency style. currency is required — any ISO 4217 code.

anyamount(1999, { mode: "currency", currency: "EUR", locale: "en" });
// "€1,999.00"

anyamount(1999, { mode: "currency", currency: "RSD", locale: "sr" });
// "1.999,00 RSD"

anyamount(1999, { mode: "currency", currency: "JPY", locale: "ja" });
// "￥1,999"  — JPY has no minor unit, Intl knows

anyamount(1999.99, { mode: "currency", currency: "EUR", locale: "en", digits: 0 });
// "€2,000"

Fraction digits default to the currency's own (2 for EUR, 0 for JPY).

Reads: locale, currency, digits.

unit

Measurements via the Intl.NumberFormat unit style. unit is required — any sanctioned identifier, including compound "<unit>-per-<unit>" pairs. The unit option is typed as a union, so your editor autocompletes it.

anyamount(3.2, { mode: "unit", unit: "gigabyte", locale: "en" });
// "3.2 GB"

anyamount(120, { mode: "unit", unit: "kilometer-per-hour", locale: "en" });
// "120 km/h"

anyamount(3.2, { mode: "unit", unit: "gigabyte", locale: "en", style: "long" });
// "3.2 gigabytes"

anyamount(5, { mode: "unit", unit: "kilometer", locale: "en", style: "narrow" });
// "5km"

Fraction digits default to 2.

Reads: locale, unit, style, digits.

---

options

Option	Type	Default	Used by
mode	"smart" | "currency" | "unit"	"smart"	—
locale	string | string[]	runtime locale	all
currency	string (ISO 4217)	— (required)	currency
unit	sanctioned unit identifier	— (required)	unit
style	"long" | "short" | "narrow"	"short"	smart, unit
digits	number (max fraction digits)	smart default	all

The options type is a discriminated union on mode — TypeScript requires currency in currency mode and unit in unit mode at compile time, and rejects options that don't belong to the mode. From plain JavaScript, the same rules hold at runtime: a missing currency or unit throws a clear TypeError, and stray options are ignored.

---

parts

anyamountParts() accepts the same arguments as anyamount() and returns the Intl.NumberFormat.formatToParts output unchanged — style the number apart from the currency symbol or unit, or rebuild the string your own way.

import { anyamountParts } from "anyamount";

anyamountParts(1999, { mode: "currency", currency: "EUR", locale: "en" });
// [
//   { type: "currency", value: "€" },
//   { type: "integer", value: "1" },
//   { type: "group", value: "," },
//   { type: "integer", value: "999" },
//   { type: "decimal", value: "." },
//   { type: "fraction", value: "00" },
// ]

// React: shrink the currency symbol
anyamountParts(price, { mode: "currency", currency: "EUR" }).map((p, i) =>
  p.type === "currency" ? <small key={i}>{p.value}</small> : p.value,
);

---

locales

Pass any valid BCP 47 tag — including regional variants like en-GB, zh-TW, pt-BR. Fallback arrays also work.

anyamount(1234567, { locale: "ru" });   // "1,2 млн"
anyamount(1234567, { locale: "de" });   // "1,2 Mio."
anyamount(1234567, { locale: "ja" });   // "123.5万"
anyamount(1234567, { locale: ["sr-Latn-RS", "en"] });

anyamount(1999, { mode: "currency", currency: "USD", locale: "de" });
// "1.999,00 $"

When omitted, native Intl uses the runtime locale.

Output is pure — no Date.now(), no environment reads — so server and client render identically. SSR-safe by construction.

---

vs the alternatives

	anyamount	pretty-bytes	filesize	numeral
gzip	~0.7kb	~1kb	~3kb	~5kb
currency	yes	no	no	yes
units beyond bytes	yes	no	no	no
localized output	200+ locales	partial	partial	manual locale files
dependencies	0	0	0	0

---

limitations

Honest ones:

• No byte auto-scaling yet. anyamount(3200000000, { mode: "unit", unit: "byte" }) will not pick GB for you — pass the unit you want. Auto-scaling is planned for a future minor.
• No percent mode, no ranges, no parsing. Deliberately one function, three modes.
• Exact output strings come from Intl and may vary between ICU versions — don't snapshot them across environments.
• Sanctioned units only. Intl supports a fixed list of unit identifiers (and -per- compounds of them) — no arbitrary custom units.

---

stability

anyamount follows semver. The 1.x API is stable: new options arrive in minors, breaking changes only in majors. Exact formatted strings come from Intl and may vary between ICU versions, so never assert on them across environments.

---

compatibility

Node.js 18+ · Chrome 77+ · Firefox 78+ · Safari 14.1+ · Edge Runtime · Cloudflare Workers · Deno

CI runs the full suite on Node 20, 22, and 24.

---

part of the any* family

• anywhen — tiny smart date formatter. One function, three modes, any locale.
• anymany — tiny Intl list formatter. Sort and join string arrays in any locale.
• anyamount — you are here.