What is happening in the numbro's world.

Release 2.3.6

numbro 2.3.6 has been released.

  • Fix spacing issue with en-GB currency. Thanks @DamienCassou
  • Fix #507: mantissa precision produces wrong results for certain numbers. Thanks @swissmanu


Release 2.3.5

numbro 2.3.5 has been released.


Release 2.3.4

numbro 2.3.4 has been released.


Release 2.3.3

numbro 2.3.3 has been released.


Release 2.3.2

numbro 2.3.2 has been released.


Release 2.3.1

numbro 2.3.1 has been released.


Release 2.3.0

numbro 2.3.0 has been released.


Release 2.2.0

numbro 2.2.0 has been released.

  • Fix dependencies through npm audit --production
  • Fix #446: CDNJS in website Relocation. Thanks @pranithan-kang.
  • Fix #364: Format Decimal without Rounding. Thanks @shefrancia.
  • Fix #414: Fix de-CH thousands separator. Thanks @FrEaKmAn.
  • Fix #418: Correct symbol and sign order for formatCurrency when forceSign=true. Thanks @adriang133.
  • Fix #424: Add ordinal for 40 for tr-TR. Thanks @yatki.
  • Fix #423: No way to have space separated abbreviation and not-separated currency symbol at the same time. Thanks @Osipova.
  • Fix #392: Small negative numbers get the leading zero incorrectly cut off. Thanks @Rudd.
  • Fix #403: Update numbro.d.ts to match the current API of the library. Thanks @Monck.
  • Fix #428: Fix id thousands and decimal separator. Thanks @kukuhyoniatmoko.
  • Fix #453: Fix broken BCP47 link. Thanks @sesam.


Release 2.1.2

numbro 2.1.2 has been released.

  • Fix #399: Update dependencies. Thanks @baer.
  • Fix #390: Small changes to doc comments. Thanks @cnrudd.
  • Fix #328: Fixed unformat for non standard delimiters. Thanks @jkettmann.


Release 2.1.1

numbro 2.1.1 has been released.

  • Fix #372: Truncated numbers with trimMantissa and zero mantissa. Thanks @timfish.
  • Fix #367: Fixes duplicate call of chooseLanguage when setting a language without subtag. Thanks @LarsBauer.
  • Fix #363: Enable es6 imports when using typescript. Thanks @aralisza.
  • Fix #353: Add monthly download to README. Thanks @BenjaminVanRyseghem.


Release 2.1.0

numbro 2.1.0 has been released.

It introduces trimMantissa allowing to have a “max mantissa length” experience.


Release 2.0.6

numbro 2.0.6 has been released.


Release 2.0.0

New year, new numbro!

numbro 2.0.0 has just been released, and it’s a complete rewrite of the code.

Hopefully, numbro 2.0.0 is 99% backward compatible with the previous version (1.11.1).

Breaking changes are:

  • unformat is now a static function instead of an instance method (numbro.unformat(myString) instead of numbro(whatever).unformat(myString))
  • not precising a mantissa now means to keep them all while it used to mean to trim it off (numbro(123.456).format(0,0) now is 123.234 instead of 123)

On the other side, this version brings some cool features in:

  • From a usage point of view:
    • a better formatting format, now using a literal object for an improved readability (note that the string format is still supported)
    • support for BigNumber, so no more rounding issues
    • defaults are now language specific, bringing more flexibility
  • From a code point of view:
    • the code is now split into modules, making it easier to read, to test and to maintain
    • usage of the ES6 specification, for an up-to-date codebase
    • usage of eslint, a javascript linter for cleaner code
    • usage of jasmine, for more advanced testing (while keeping all previous tests)
    • usage of istanbul, ensuring a 100% test coverage ratio!

More details can be found in the PR #305


Release 1.11.1

numbro 1.11.1 has been released.


Release 1.11.0

numbro 1.11.0 has been released.


Release 1.10.1

numbro 1.10.1 has been released.


Release 1.10.0

numbro 1.10.0 has been released.


Release 1.9.3

numbro 1.9.3 has been released.

  • Fix #184: Accurate, up-to-date type definitions for TypeScript. Thanks @dpoggi.
  • Fix #196: Fix german language specifications. Thanks @Ben305.
  • Fix #197: Add detection for Meteor. Thanks @Ben305.
  • Fix #206: fix number formats for de-CH. Thanks @Remo.


Release 1.9.0

numbro 1.9.0 has been released.

  • Fix #192: Add locales en-AU and en-NZ. Thanks @Ben305.
  • Fix #193: Add function formatForeignCurrency. Thanks @Ben305.
  • Fix #194: Fix undefined error on React native. Thanks @balhier.


Release 1.8.1

numbro 1.8.1 has been released.

  • Fix #182: Added support for numbers without leading zero. Thanks @budnix.
  • Fix #183: Number validation doesn’t validate negative numbers. Thanks @budnix.


Release 1.8.0

numbro 1.8.0 has been released.


Release 1.7.1

numbro 1.7.1 has been released.

  • Fix #142: Limit packaging extraneous files. Thanks @MarkHerhold.
  • Fix #143: Fixing web build. Thanks @mmollick.
  • Fix #149: Allow loading of cultures in node explicitly if numbro hasn’t detected correctly that it is in node. Thanks @stewart42.
  • Fix #147: Fixing formatting issues for very small (+/-1e-23) numbers. Thanks @MarkHerhold.


Release 1.7.0

numbro 1.7.0 has been released.


Release 1.6.2

numbro 1.6.2 has been released.

Two hotfixes today as we are moving the API.


  • Fix deprecated use of language and introduce cultureCode


  • Fix languages to use proper intPrecision
  • Fix intPrecision when value is 0


Release 1.6.0

numbro 1.6.0 has been released.

This version brings new API functions to replace the language based functions. Those are now deprecated, and a equivalent has been introduced.

  • Introduced new API functions:

    • setCulture
    • culture
    • cultureData
    • cultures
  • Deprecated API functions:

    • setLanguage
    • language
    • languageData
    • languages

Those deprecated functions will be removed in version 2.0.0


Release 1.5.2

numbro 1.5.2 has been released.

This release brings a few fixes and improvements, especially for Browserify users.

Let’s hope you’ll like this new version.


Release 1.5.0

numbro 1.50 has been released.

We are proud to announce a new release of numbro today. Actually, we did tree releases today (we like to keep them small).

Basically, it brings now support for Hebrew (thanks to @eli-zehavi), automatic load of all languages for node users (thanks to @alexkwolfe), and an improvement in the decimal accuracy when minified (thanks to @rafde).

I hope you will have fun with this new release,


Release 1.3.1

numbro 1.3.1 has been released.

This release is also a very small one, but it fixes a quite annoying bug preventing numbro from being browserified. Now thanks to @avetisk, it can be.


Release 1.3.0

numbro 1.3.0 has been released.

It’s a very small release but it contains a new feature (requested by @Benoss) about int precision.

You can read the new documentaion about it here.


Release 1.2.2

numbro 1.2.2 has been released.

With a lot of bug fixes (and a big thank you to @Graham42), we all hope you will enjoy this new release.

The complete changelog can be found here.


New website

numbro has a fresh new website

With these, let me introduce to you Ranko the Raccoon, the numbro mascott


I hope you we like the new website as much as I enjoy doing it.