numbro

What is numbro?

Numbro is a JavaScript library for formatting and manipulating numbers. It provides a wide range of functionalities including number formatting, currency formatting, and parsing numbers from strings.

What are numbro's main functionalities?

Number Formatting

This feature allows you to format numbers with various options such as decimal places, thousand separators, and more.

const numbro = require('numbro');
console.log(numbro(1000.234).format('0,0.00')); // '1,000.23'

Currency Formatting

This feature allows you to format numbers as currencies, including options for thousand separators and decimal places.

const numbro = require('numbro');
console.log(numbro(1000.234).formatCurrency({ thousandSeparated: true, mantissa: 2 })); // '$1,000.23'

Parsing Numbers

This feature allows you to parse formatted number strings back into JavaScript numbers.

const numbro = require('numbro');
console.log(numbro().unformat('1,000.23')); // 1000.23

Other packages similar to numbro

numeral

Numeral.js is a library for formatting and manipulating numbers. It offers similar functionalities to numbro, such as number formatting, currency formatting, and parsing. However, numbro provides additional features like locale support and more advanced formatting options.

accounting

Accounting.js is a lightweight JavaScript library for number, money, and currency formatting. While it offers basic formatting functionalities similar to numbro, it lacks some of the advanced features and flexibility that numbro provides.

currency.js

Currency.js is a library focused on handling and formatting currency values. It provides a more specialized set of features for currency manipulation compared to numbro, which offers a broader range of number formatting options.

README

numbro

A javascript library for formatting and manipulating numbers.

Website and documentation

Travis Build Status

Master

Develop

NPM

Contributing

Please submit all pull requests to the develop branch.

1. Fork the library

2. Install grunt

3. Run npm install to install dependencies

4. Add your tests to the files in /tests

5. To test your tests, run grunt test

6. When all your tests are passing, submit a pull request to the develop branch.

Languages

Languages names follows the Microsoft culture name convention as found here. If Microsoft does not have a code for the country/locale combination, use the format lang-locale where the language code is a 2 letter abbreviation from the list of ISO 639-1 language codes and the localecode is from the list of ISO 3166-1 country codes

Language translations will not be merged without unit tests.

See the english unit tests for an example.

Changelog

See CHANGELOG.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

Copyright © 2014 Adam Draper

Copyright © 2015-2016 Företagsplatsen AB

---

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

Changelog

1.11.0

• Fix #232: update numbro.d.ts to use export = instead of export default. Thanks @olmobrutall.
• Fix #241: Added bg localization. Thanks @gwynjudd.
• Fix #248: Fix index.js generation for culture neutral codes. Thanks @gwynjudd.
• Fix #255: Allow four character country code. Thanks @gwynjudd.
• Fix #260: Added el localization. Thanks @gwynjudd.
• Fix #269: Fix thousands and decimal separator for en-ZA. Thanks @gwynjudd.
• Fix #271: Added es-CL localization. Thanks @gwynjudd.
• Fix #272: Added es-CO localization. Thanks @gwynjudd.
• Fix #273: Added es-CR localization. Thanks @gwynjudd.
• Fix #274: Added es-NI localization. Thanks @gwynjudd.
• Fix #275: Added es-PE localization. Thanks @gwynjudd.
• Fix #276: Added es-PR localization. Thanks @gwynjudd.
• Fix #277: Added es-SV localization. Thanks @gwynjudd.