Short Scale Units

A simple package providing helper functions for matching numbers with their short scale unit.

Table of Context

• Installation
• Import/Require
• API
  • unitNameFromNumber
  • numberFromUnitName
  • trimNumber
  • trimName
  • getUnitPower
  • getPower
• Supported Units

Installation

npm install short-scale-units

Import/Require

// TypeScript
import * as ssu from "short-scale-units";

// JavaScript
const ssu = require("short-scale-units");

API

unitNameFromNumber

Provides the English unit name for the given number.

const name = ssu.unitNameFromNumber(17388);
// name = "thousand"

numberFromUnitName

Provides the base unit number for the given unit name.

const integer = ssu.numberFromUnitName("thousand");
const notation = ssu.numberFromUnitName("sextillion");
const raw = ssu.numberFromUnitName("sextillion", true);
// number = 1000
// notation = 1e+21
// raw = "1000000000000000000000"

trimNumber

Provides the short-hand abbreviation of a number, relative to its unit.

const trimmed = ssu.trimNumber(17388);
// trimmed = 17 (because 17388 is 17 thousands)

trimName

Provides an abbreviation of the unit name;

const abbreviation = trimName("thousand");
// abbreviation = "K"

getUnitPower

Provides the power for the given number, relative to its unit.

• If you want the numbers real power use getPower.

const unitPower = ssu.getUnitPower(17388);
// unitPower = 3

getPower

Provides the power for the given number.

• If you want the power relative the its unit use getUnitPower.

const powerRound = ssu.getPower(17388, true);
const power = ssu.getPower(17388);
// powerRound = 4
// power = 4.240249631518799

Supported Units

| Unit Name | Unit Power | Unit Abbreviation | | --------- | ---------- | ----------------- | | one | 0 | O | | ten | 1 | T | | hundred | 2 | H | | thousand | 3 | K | | million | 6 | M | | billion | 9 | B | | trillion | 12 | Tr | | quadrillion | 15 | Qd | | quintillion | 18 | Qt | | sextillion | 21 | Sxt | | septillion | 24 | Spt | | octillion | 27 | Ot | | nonillion | 30 | Nn | | decillion | 33 | Dc | | undecillion | 36 | Ud | | duodecillion | 39 | Dd | | tredecillion | 42 | Td | | quattuordecillion | 45 | Qtd | | quindecillion | 48 | Qnd | | sexdecillion | 51 | Sxd | | septendecillion | 54 | Std | | octodecillion | 57 | Od | | novemdecillion | 60 | Nd | | vigintillion | 63 | V | | unvigintillion | 66 | Uv | | duovigintillion | 69 | Dv | trevigintillion | 72 | Tv | | quattuorvigintillion | 75 | Qtv | | quinvigintillion | 78 | Qnv | | sexvigintillion | 81 | Sxv | | septenvigintillion | 84 | Stv | | octovigintillion | 87 | Ov | | novemvigintillion | 90 | Nv | | trigintillion | 93 | Tg | | untrigintillion | 96 | Utg | | duotrigintillion | 99 | Dtg | | tretrigintillion | 102 | Ttg | | quattuortrigintillion | 105 | Qttg | | quintrigintillion | 108 | Qntg | | sextrigintillion | 111 | Sxtg | | septentrigintillion | 114 | Sttg | | octotrigintillion | 117 | Otg | | novemtrigintillion | 120 | Ntg | | quadragintillion | 123 | Qdr | | unquadragintillion | 126 | Uqdr | | duoquadragintillion | 129 | Dqdr | | trequadragintillion | 132 | Tqdr | | quattuorquadragintillion | 135 | Qtqdr | | quinquadragintillion | 138 | Qnqdr | | sexquadragintillion | 141 | Sxqdr | | septenquadragintillion | 144 | Stqdr | | octoquadragintillion | 147 | Oqdr | | novemquadragintillion | 150 | Nqdr | | quinquagintillion | 153 | Qng | | unquinquagintillion | 156 | Uqng | | duoquinquagintillion | 159 | Dqng | | trequinquagintillion | 162 | Tqng | | quattuorquinquagintillion | 165 | Qtqng | | quinquinquagintillion | 168 | Qnqng | | sexquinquagintillion | 171 | Sxqng | | septenquinquagintillion | 174 | Stqng | | octoquinquagintillion | 177 | Oqng | | novemquinquagintillion | 180 | Nqng | | sexagintillion | 183 | Sxa | | unsexagintillion | 186 | Usxa | | duosexagintillion | 189 | Dsxa | | tresexagintillion | 192 | Tsxa | | quattuorsexagintillion | 195 | Qtsxa | | quinsexagintillion | 198 | Qnsxa | sexsexagintillion | 201 | Sxsxa | | septsexagintillion | 204 | Stsxa | | octosexagintillion | 207 | Osxa | | novemsexagintillion | 210 | Nsxa | | septuagintillion | 213 | Spg | | unseptuagintillion | 216 | Uspg | | duoseptuagintillion | 219 | Dspg | | treseptuagintillion | 222 | Tspg | | quattuorseptuagintillion | 225 | Qtspg | | quinseptuagintillion | 228 | Qnspg | | sexseptuagintillion | 231 | Sxspg | | septseptuagintillion | 234 | Stspg | | octoseptuagintillion | 237 | Ospg | | novemseptuagintillion | 240 | Nspg | | octogintillion | 243 | Og | | unoctogintillion | 246 | Uog | | duooctogintillion | 249 | Dog | | treoctogintillion | 252 | Tog | | quattuoroctogintillion | 255 | Qtog | | quinoctogintillion | 258 | Qnog | | sexoctogintillion | 261 | Sxog | | septoctogintillion | 264 | Stog | | octooctogintillion | 267 | Oog | | novemoctogintillion | 270 | Nog | | nonagintillion | 273 | Ng | | unnonagintillion | 276 | Ung | | duononagintillion | 279 | Dng | | trenonagintillion | 282 | Tng | | quattuornonagintillion | 285 | Qtng | | quinnonagintillion | 288 | Qnng | | sexnonagintillion | 291 | Sxng | | septnonagintillion | 294 | Stng | | octononagintillion | 297 | Ong | | novemnonagintillion | 300 | Nng | | centillion | 303 | C |