Skip to content

The coolest money formatting helper for JavaScript! 💸

License

Notifications You must be signed in to change notification settings

jlozovei/format-money

Repository files navigation

@jlozovei/format-money

The coolest money formatting helper for JavaScript! 💸

codecov Release

📜 About

Have you ever needed to format money using JavaScript?
Have you ever thought about how do to it without any lib?
Do you know you can do it with plain JS?

If you already asked one of those questions above, you've find what you're looking for!

@jlozovei/format-money is a cool helper, made with plain JS (no deps!) to give you formatted currency/money strings, with any kind of currency available in the world!

No dependencies, no framework - just plain JS!

📕 How to use

First things first - install the package using npm or yarn:

# using npm
npm i @jlozovei/format-money

# using yarn
yarn add @jlozovei/format-money

After that, import the helper wherever you want to use it:

// es-modules
import formatMoney from '@jlozovei/format-money';

// commonjs
const formatMoney = require('@jlozovei/format-money');

Then, you'll be able to use it:

const localized = formatMoney('123456789'); // "$123,456,789.00"

// or

const localized = formatMoney({
  value: '123456789',
  currencyCode: 'EUR',
  locale: 'DE'
}); // "123.456.789,00 €"

Avaliable Options

Name Type Description Example
value string, number The output language 123
locale string The output language pt-BR
currencyCode string The currency code USD

💻 Developing

First, fork the project. After it, install the dependencies (preferably using npm - since the project is using it) and do the work.

Also, take a look at the contributing guide!

🤔 I want to use it, but I don't want to install it

Cool! So, the magic under the hood is basically using the number.toLocaleString() method, passing some cool parameters to create the formatted currency string:

const number = 123456.789;

number.toLocaleString('de-DE', { style: 'currency', currency: 'EUR' }); // "123.456,79 €"
number.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }); // "¥123,457"
  • The 1st parameter is the locale: the output language for your formatting (en-US, pt-BR, es-MX...);
  • The 2nd is an options object: here you can tell the style of the formatting and the currency code type you want;
    • style: currency, decimal or percent (for this case we want to use currency);
    • currency code: any currency code available, like BRL, EUR, USD;

Please note that the locale, or the output language will be how the string is written, and the currency code will be how the number is written under that code.

Take the following code:

const number = 123456.789;

number.toLocaleString('en-US', { style: 'currency', currency: 'BRL' }); // "R$123.456,79"
number.toLocaleString('pt-BR', { style: 'currency', currency: 'BRL' }); // "R$ 123.456,79"
  • The first toLocaleString is displaying how the number will be formatted under the BRL currency code (Brazilian Real), using the en-US locale (english from United States);
  • The second toLocaleString is displaying how the number will be formatted under the BRL currency code (Brazilian Real), using the pt-BR locale (portuguese from Brazil);

🔐 License

Licensed under the MIT.