npmpackage.info

Gathering detailed insights and metrics for condense-number

Other packages similar to condense-number

condense-newlines

0.2.1

Replace extraneous newlines with a single newline, or pass a specified number of newlines to use.

@shopify/condense-number

1.0.1

![](https://github.com/shopify/condense-number/workflows/CI/badge.svg)

Gathering detailed insights and metrics for condense-number

condense-number - 1.0.1 | npmpackage.info

condense-number

Locale-aware number condensing

1.0.1

MIT

TypeScript

48.94 kB

3.8

Installations

npm install condense-number

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

12.22.7

NPM Version

7.24.2 Pull Requests

Open

6

Total

87

Closed

28

Merged

53

Issues

Open

3

Total

25

Closed

22

Releases

Unable to fetch releases

Languages

TypeScript

JavaScript

TypeScript (99.71%)

JavaScript (0.29%)

Developer

Shopify

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

43 Stars

114 Commits

6 Forks

374 Watchers

13 Branches

7,067 Contributors

Updated on Jun 03, 2025

Maintainers

View All 7,067 Contributors

Package Meta Information

Latest Version

1.0.1

Package Id

condense-number@1.0.1

Unpacked Size

48.94 kB

Size

8.94 kB

File Count

NPM Version

7.24.2

Node Version

12.22.7

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@types/jest eslint eslint-plugin-prettier eslint-plugin-shopify in-publish jest microbundle prettier ts-jest chaostest typescript

condense-number

Locale-aware number and currency condensing.

condense-number uses Unicode Common Locle Data Repository (CLDR) and Intl.js formatting patterns to inform locale-aware number and currency condensing. What does number condensing mean? In English 50,000 condenses to 50K, but it's 50 mil in Portuguese and 5 万 in Japanese.

The following locales are now available in condense-number:

Danish (da)
German (de)
Greek (el)
English (en)
Spanish (es)
Finnish (fi)
French (fr)
Hindi (hi)
Italian (it)
Japanese (ja)
Korean (ko)
Malay (ms)
Norwegian (nb-NO)
Dutch (nl)
Polish (pl)
Brazilian Portuguese (pt-BR)
Romanian (ro)
Russian (ru)
Swedish (sv)
Thai (th)
Turkish (tr)
Chinese (Simplified) (zh-CN)
Chinese (Traditional) (zh-TW)

How to use

Install condense-number in your project:

1yarn add condense-number

Both condenseNumber and condenseCurrency are exported as named exports and can be imported individually.

condenseNumber

Provide a number and locale, get the condensed value. If a condensed value isn't applicable, condenseNumber returns the number with formatting, if appropriate.

Example:

condenseNumber(1000, 'en') = '1K'

Optionally, specify maximum precision within an options object to override the default decimal precision of 0. Precision will not be applied if the decimal value is 0.

condenseNumber(1500, 'en', {maxPrecision: 1}) = '1.5K'

condenseCurrency

Provide a number, locale and currency code, get the value with the currency provided, formatted according to the locale's standards. If a condensing isn't applicable, condenseCurrency returns the currency with formatting, but without condensing.

condenseCurrency(15000, 'en', 'usd') = '$15K';

Optionally, specify maximum precision within an options object to override the default decimal precision of 0. Precision will not be applied if the decimal value is 0.

condenseCurrency(1500, 'en', 'gbp', {maxPrecision: 1}) = '£1.5K'

When a currency symbol is not found, the capitalized currency code will be used instead. For example:

condenseCurrency(150000, 'en', 'abc') = 'ABC150K'

Rounding

By default, condensed numbers round down. For example:

condenseNumber(1500, 'en') = '1K'

However, if you want to round to the closest integer or always round up to the next integer, you can specify that in the options object, by using 'auto' or 'up':

condenseNumber(1200, 'en', {roundingRule: 'auto'}) = '1K'

condenseCurrency(1100, 'en', 'gbp', {roundingRule: 'up'})

= '£2K'

Rounding can be used with maxPrecision.

condenseNumber(1089, 'en', {roundingRule: 'auto', maxPrecision: 1});

= 1.1K

How it works

If you're curious, have a look at the CLDR data used under the hood. The logic we apply to the JSON is informed by documentation (here and here) from Unicode. We use Intl.js, which also relies on CLDR data, to inform our currency codes and number patterns.

Development instructions

Install the specified Node version: nvm install
Install dependencies: npx yarn install

You can now run:

Test: npx yarn run test
Code formatting: npx yarn run format
Building: npx yarn run build

No vulnerabilities found.

10

License

Determines if the project has defined a license.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

9

Security-Policy

Determines if the project has published a security policy.

8

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.8

/10

Last Scanned on 2024-07-01

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More