Have ideas to improve npm?Join in the discussion! »

    number-currency-format

    1.0.10 • Public • Published

    npm version Build Status

    Number currency format

    Zero-dependency, cross-browser, lightweight and flexible utility for number/price formatting that you control.

    Installation

    npm i number-currency-format
    

    or

    yarn add number-currency-format
    

    Usage

    Format

    const { format } = require('number-currency-format');
     
    format(1999.99);
    // '1,999.99'

    Setting currency

    format(1999.99, {
        currency: ''
    });
    // '1,999.99 €'

    Setting other formatting options

    format(1999.99, {
        currency: '$',
        spacing: false,
        currencyPosition: 'LEFT'
    })
    //'$1,999.99'

    Unformat

    const { unformat } = require('number-currency-format');
     
    unformat('1.999,99');
    // 1999.99

    Currencies

    const { unformat } = require('number-currency-format');
     
    unformat('$ 199.990,05');
    // 199990.05

    To see all supported usecases and example usages, run npm test or yarn test.

    API

    format

    format(numbernumber, options?: FormattingOptions)

    Formats number given defined formatting options

    • number: number - Number to be formatted
    • options?: FormattingOptions - Formatting options (optional)

    FormattingOptions

    • currency: string - Currency symbol to be printed next to the formatted number. By default: none
    • thousandSeparator: string - Symbol separating thousands. By default: ,
    • decimalSeparator: string - Symbol separating decimals. By default: .
    • decimalsDigits: number - Number of decimal digits. By default: 2
    • showDecimals: string - ALWAYS, IF_NEEDED, AS_IS or NEVER. IF_NEEDED does not show the decimal if it is 0 (and if it is different than 0, shows exactly {decimalsDigits} decimal digits). AS_IS preserves the decimal depth of the source number. By default: ALWAYS
    • currencyPosition: string - LEFT or RIGHT. By default: RIGHT
    • spacing: boolean - Spacing between currency and price. By default: true
    • arithmeticalRounding: boolean - Use arithmetical rounding (always half-up) instead of tie break rounding. By default: false (so: the rounding will include tie-breaking)

    All configuration is optional.

    unformat

    unformat(textstring, options?: FormattingOptions)

    Reads the number out of a string that looks like a price.

    • text: text - Text to be unformatted
    • options?: FormattingOptions - Formatting options (optional). Currently only decimalSeparator is supported by the unformatter as the rest of the options don't really make sense and the unformatter can extract the price out of the text anyway.

    Compatibility

    This works in every modern browser as well as on the server. This module does not contain and will never contain any dependency at all. This module does not use any 3rd party bundler, transpiler, compiler or test runner. Vanilla all the way 😎.

    Why not using intl or other packages?

    Intl does not offer full flexibility around price formatting and has an overhead of loading all locale files. Additionally it requires polyfill for old browsers and headless testing. This library is bare to the bone and does not contain all possible locales definition and gives you all possible formatting options to support all known price formats.

    Install

    npm i number-currency-format

    DownloadsWeekly Downloads

    1,248

    Version

    1.0.10

    License

    ISC

    Unpacked Size

    24.2 kB

    Total Files

    7

    Last publish

    Collaborators

    • avatar