BenjaminVanRyseghem/numbro

A JS library for number formatting

JavaScript

1,144

861 commits

updated Oct 17, 2025

numbrojs.com

See the code

README

numbro

A javascript library for formatting and manipulating numbers.

Website and documentation

Travis Build Status

Master

Develop

NPM

Contributing

See the CONTRIBUTING.md file for contribution information.

Languages

Language tags follow the BCP 47 specification.

Language translations will not be merged without unit tests.

See the english unit tests for an example.

Changelog

See CHANGELOG.md. For the original project (Numeral.js) changelog, see CHANGELOG-Numeraljs.md.

Acknowledgements

numbro is forked from Adam Draper's project Numeral.js, which was in turn inspired by and heavily borrowed from Moment.js.

License

Distributed under the MIT license. If you want to know more, see the LICENSE file.

The original license file for Numeral.js can be found in LICENSE-Numeraljs

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_A---- 💻	_Aaron 💻	_{Adam Draper} 💻	_{Adrian Buzea} 💻	_{Ahmed Al Hafoudh} 💻	_{Alan Kendall} 💻	_{Alex Anthony} 🐛 💻
_{Alex Wolfe} 💻	_{Amir E. Aharoni} 💻	_{Anatoli Papirovski} 💻	_{Andrei Alecu} 💻	_{Andrew Laucius} 💻	_{Andrew May} 💻	_{Anna Osipova} 💻
_{Anthony Short} 💻	_{Aster Haven} 💻	_{Austin Greco} 💻	_{Avétis KAZARIAN} 💻	_{Benjamin Van Ryseghem} 💻	_{Brad Rodriguez} 💻	_{Chris Earle} 💻
_{Chris Nanney} 💻	_{Chris Nicola} 💻	_{Clay Walker} 💻	_{Colin Rudd} 💻	_{Damien Cassou} 💻	_{Dan Poggi} 💻	_{Dan Ristic} 💻
_{Dave Clayton} 💻	_{Dieter Luypaert} 💻	_{Diogo Resende} 💻	_{Dominik Bułaj} 💻	_{Dylan Aïssi} 🤔	_{Ecmel Ercan} 💻	_{Eli Zehavi} 💻
_{Emily Shi} 💻	_{Eric Baer} 💻	_Erol 💻	_{Graham McGregor} 💻	_{Gregor Aisch} 💻	_{Guus Goossens} 💻	_{Gwyn Judd} 💻
_{Herinson Rodrigues} 💻	_{Hernan Garcia} 💻	_{Isha Sharma} 🐛	_{Jan Peša} 💻	_{Jarno van Leeuwen} 💻	_{Joe Bordes} 💻	_Johannes 💻
_{Jordan Neill} 💻	_{Jordy de Jong} 💻	_KableM 💻	_{Koes Bong} 💻	_{Krzysztof Budnik} 💻	_{Kukuh Yoniatmoko} 💻	_{Lars Bauer} 💻
_{Lauris BH} 💻	_{Luís Rudge} 💻	_{Léo Renaud-Allaire} 💻	_{MJ Abadilla} 💻	_{Mahesh Senniappan} 💻	_{Manuel Alabor} 💻	_{Marco Krage} 💻
_Marcus 💻	_{Mark Herhold} 💻	_{Martin Večeřa} 🐛 💻	_{Mehmet Yatkı} 💻	_{Michael Piefel} 💻	_{Michael Storgaard} 💻	_{Michiel ter Reehorst} 💻
_Mike 💻	_{Mike Guida} 💻	_{Mudit Ameta} 💻	_{Nicolas HENRY} 💻	_{Nicolas Petton} 💻	_{Olmo del Corral} 💻	_OvidiuBan 🐛
_{Peter Bakondy} 💻	_{Peter Dave Hello} 💻	_Quinn 💻	_{Rafael De Leon} 💻	_{Ramesh Nair} 💻	_{Randy Wilander} 💻	_{Raymond Ha} 💻
_{Remo Laubacher} 💻	_RichColours 🐛	_{Rusty Bailey} 💻	_{Sami Saada} 💻	_{Shane Reustle} 💻	_Sherlyne 💻	_{Simon B.} 💻
_{Stewart Scott} 💻	_{Sébastien Chopin} 💻	_T0nio 💻	_{Tamás Nepusz} 💻	_{Ted Ge} 💻	_{Teppei Sato} 💻	_{The Gitter Badger} 💻
_{Thomas Obermüller} 💻	_Tim 💻	_{Tim Fish} 💻	_{Tim Schauder} 💻	_{Tomas Carnecky} 💻	_{Xiaopei Li} 💻	_{Zeke Sikelianos} 💻
_ben305 💻	_{bhartidengada} 💻	_daclayton 💻	_gtrombi 💻	_j0nixs 🐛	_jojosati 💻	_phil 💻
_rWilander 💻	_ragulka 💻	_seedy 🐛	_sousarka 💻	_xiaoli 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Funding

If you want to give me a hand, you can consider buying me a ko-fi, or becoming a sponsor.

formatting

hacktoberfest

javascript

numbers

Project health

Overall

3.2/10

Maintained

0/10

Code review

1/10

OpenSSF Scorecard

npm

numbro

Latest release

2.5.0 · Apr 4, 2024

Releases this year

Significant stargazers

Hendy Irawan

353 followers · starred Dec 2022

Julien Le Coupanec

2,797 followers · starred Jun 2023

Nick Carchedi

521 followers · starred Jan 2021

Xiao

153 followers · starred Mar 2025

Similar repos

adamwdraper/Numeral-js

A javascript library for formatting and manipulating numbers.

9,698

autoNumeric/autoNumeric

AutoNumeric is a standalone library that provides live as-you-type formatting for international…

1,805

brazilian-utils/javascript

Utils library for specific Brazilian businesses

1,680

d3/d3-format

Format numbers for human consumption.

643

all-contributors/all-contributors

✨ The all-contributors bot website and documentation. Recognize all contributors, not just the ones…

8,111

kentcdodds/all-contributors

✨ The all-contributors bot website and documentation. Recognize all contributors, not just the ones…

8,111

formatjs/formatjs

The monorepo home to all of the FormatJS related libraries, most notably react-intl.

14,742

jfmengels/all-contributors-cli

Tool to help automate adding contributor acknowledgements according to the all-contributors…

423

BenjaminVanRyseghem/numbro

A JS library for number formatting

JavaScript

1,144

861 commits

updated Oct 17, 2025

numbrojs.com

See the code

README

numbro

A javascript library for formatting and manipulating numbers.

Website and documentation

Travis Build Status

Master

Develop

NPM

Contributing

See the CONTRIBUTING.md file for contribution information.

Languages

Language tags follow the BCP 47 specification.

Language translations will not be merged without unit tests.

See the english unit tests for an example.

Changelog

See CHANGELOG.md. For the original project (Numeral.js) changelog, see CHANGELOG-Numeraljs.md.

Acknowledgements

numbro is forked from Adam Draper's project Numeral.js, which was in turn inspired by and heavily borrowed from Moment.js.

License

Distributed under the MIT license. If you want to know more, see the LICENSE file.

The original license file for Numeral.js can be found in LICENSE-Numeraljs

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_A---- 💻	_Aaron 💻	_{Adam Draper} 💻	_{Adrian Buzea} 💻	_{Ahmed Al Hafoudh} 💻	_{Alan Kendall} 💻	_{Alex Anthony} 🐛 💻
_{Alex Wolfe} 💻	_{Amir E. Aharoni} 💻	_{Anatoli Papirovski} 💻	_{Andrei Alecu} 💻	_{Andrew Laucius} 💻	_{Andrew May} 💻	_{Anna Osipova} 💻
_{Anthony Short} 💻	_{Aster Haven} 💻	_{Austin Greco} 💻	_{Avétis KAZARIAN} 💻	_{Benjamin Van Ryseghem} 💻	_{Brad Rodriguez} 💻	_{Chris Earle} 💻
_{Chris Nanney} 💻	_{Chris Nicola} 💻	_{Clay Walker} 💻	_{Colin Rudd} 💻	_{Damien Cassou} 💻	_{Dan Poggi} 💻	_{Dan Ristic} 💻
_{Dave Clayton} 💻	_{Dieter Luypaert} 💻	_{Diogo Resende} 💻	_{Dominik Bułaj} 💻	_{Dylan Aïssi} 🤔	_{Ecmel Ercan} 💻	_{Eli Zehavi} 💻
_{Emily Shi} 💻	_{Eric Baer} 💻	_Erol 💻	_{Graham McGregor} 💻	_{Gregor Aisch} 💻	_{Guus Goossens} 💻	_{Gwyn Judd} 💻
_{Herinson Rodrigues} 💻	_{Hernan Garcia} 💻	_{Isha Sharma} 🐛	_{Jan Peša} 💻	_{Jarno van Leeuwen} 💻	_{Joe Bordes} 💻	_Johannes 💻
_{Jordan Neill} 💻	_{Jordy de Jong} 💻	_KableM 💻	_{Koes Bong} 💻	_{Krzysztof Budnik} 💻	_{Kukuh Yoniatmoko} 💻	_{Lars Bauer} 💻
_{Lauris BH} 💻	_{Luís Rudge} 💻	_{Léo Renaud-Allaire} 💻	_{MJ Abadilla} 💻	_{Mahesh Senniappan} 💻	_{Manuel Alabor} 💻	_{Marco Krage} 💻
_Marcus 💻	_{Mark Herhold} 💻	_{Martin Večeřa} 🐛 💻	_{Mehmet Yatkı} 💻	_{Michael Piefel} 💻	_{Michael Storgaard} 💻	_{Michiel ter Reehorst} 💻
_Mike 💻	_{Mike Guida} 💻	_{Mudit Ameta} 💻	_{Nicolas HENRY} 💻	_{Nicolas Petton} 💻	_{Olmo del Corral} 💻	_OvidiuBan 🐛
_{Peter Bakondy} 💻	_{Peter Dave Hello} 💻	_Quinn 💻	_{Rafael De Leon} 💻	_{Ramesh Nair} 💻	_{Randy Wilander} 💻	_{Raymond Ha} 💻
_{Remo Laubacher} 💻	_RichColours 🐛	_{Rusty Bailey} 💻	_{Sami Saada} 💻	_{Shane Reustle} 💻	_Sherlyne 💻	_{Simon B.} 💻
_{Stewart Scott} 💻	_{Sébastien Chopin} 💻	_T0nio 💻	_{Tamás Nepusz} 💻	_{Ted Ge} 💻	_{Teppei Sato} 💻	_{The Gitter Badger} 💻
_{Thomas Obermüller} 💻	_Tim 💻	_{Tim Fish} 💻	_{Tim Schauder} 💻	_{Tomas Carnecky} 💻	_{Xiaopei Li} 💻	_{Zeke Sikelianos} 💻
_ben305 💻	_{bhartidengada} 💻	_daclayton 💻	_gtrombi 💻	_j0nixs 🐛	_jojosati 💻	_phil 💻
_rWilander 💻	_ragulka 💻	_seedy 🐛	_sousarka 💻	_xiaoli 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Funding

If you want to give me a hand, you can consider buying me a ko-fi, or becoming a sponsor.

formatting

hacktoberfest

javascript

numbers

Project health

Overall

3.2/10

Maintained

0/10

Code review

1/10

OpenSSF Scorecard

npm

numbro

Latest release

2.5.0 · Apr 4, 2024

Releases this year

Significant stargazers

Hendy Irawan

353 followers · starred Dec 2022

Julien Le Coupanec

2,797 followers · starred Jun 2023

Nick Carchedi

521 followers · starred Jan 2021

Xiao

153 followers · starred Mar 2025

Similar repos

adamwdraper/Numeral-js

A javascript library for formatting and manipulating numbers.

9,698

autoNumeric/autoNumeric

AutoNumeric is a standalone library that provides live as-you-type formatting for international…

1,805

brazilian-utils/javascript

Utils library for specific Brazilian businesses

1,680

d3/d3-format

Format numbers for human consumption.

643

all-contributors/all-contributors

✨ The all-contributors bot website and documentation. Recognize all contributors, not just the ones…

8,111

kentcdodds/all-contributors

✨ The all-contributors bot website and documentation. Recognize all contributors, not just the ones…

8,111

formatjs/formatjs

The monorepo home to all of the FormatJS related libraries, most notably react-intl.

14,742

jfmengels/all-contributors-cli

Tool to help automate adding contributor acknowledgements according to the all-contributors…

423