README.md

Numeral.js V2

A javascript library for formatting and manipulating numbers.

Acknowledgement

This Repository is forked from Numeral.js.

Contributing

Important: Please create your branch from and submit pull requests to the develop branch. All pull requests must include the appropriate tests.

1. Fork the library

2. Run npm install to install dependencies

3. Create a new branch from develop

4. Add your tests to the files in /tests

5. To test your tests, run grunt

6. When all your tests are passing, run grunt dist to compile and minify all files

7. Submit a pull request to the develop branch.

Formats

Formats now exist in their own files and act more or less as plugins. Check out the bytes format for an example of how to create one.

Locales

When naming locale files use the ISO 639-1 language codes supplemented by ISO 3166-1 country codes when necessary.

Locale translations will not be merged without unit tests.

See the english unit tests for an example.

Added abbreviations for thousands and millions using 'a' in the format

New parameters Added to the register functions

1. Now you can pass the abbreviations numbers that will be user in numeral

Example

numeral.register('locale', 'in', {
        delimiters: {
            thousands: ',',
            decimal: '.'
        },
        trillion: 1000000000,
        billion: 10000000,
        million: 100000
})

2. You can also Pass the regex that will be used to split the numbers.

Example for Indian Country

numeral.register('locale', 'in', {
        delimiters: {
            thousands: ',',
            decimal: '.'
        },
        trillion: 1000000000,
        billion: 10000000,
        million: 100000,
        regex: /(\d)(?=(\d\d)+\d$)/g,
})

Input - numeral(1290704).format("0,00") 
Output - 12,90,704

3. You can also pass the abbreviations_detail that will be used in stringToNumber

Example

numeral.register('locale', 'in', {
        delimiters: {
            thousands: ',',
            decimal: '.'
        },
        trillion: 1000000000,
        billion: 10000000,
        million: 100000,
        regex: /(\d)(?=(\d\d)+\d$)/g,
        abbreviations: {
            thousand: 'k',
            million: 'l',
            billion: 'cr',
            trillion: 'a'
        },
        abbreviations_detail: {
            thousand: 2,
            million: 5,
            billion: 7,
            trillion: 9
        }
})