Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

num-format · GitHub license Version 0.1.0 Coverage Status CI Status PRs Welcome

Number pretty printer for currency, percents, and adding thousands separators.

FormatCurrency

Parameters

  • number: Number - Value to convert
  • roundToInteger: Boolean - Defaults to true (Optional)
  • locale: String - Defaults to 'en-US' (Optional)
  • currency: String - Defaults to 'USD' (Optional)

Examples

  // Pretty Print: Currency (w/ Cents - Trailing 0s)
>> FormatCurrency(123456, false); // '$123,456.00'

  // Pretty Print: Currency (w/ Cents)
>> FormatCurrency(123456.78, false); // '$123,456.78'


  // Pretty Print: Currency (Rounded)
>> FormatCurrency(9876.54); // '$9,877'


  // Pretty Print: Currency (Locale Override - United Kingdom - Integer)
>> FormatCurrency(123456.78, true, 'en-GB', 'GBP'); // '£123,457'

FormatNumber

Parameters

  • number: Number - Value to convert
  • precision: Number - Defaults to 2 (Optional)
  • locale: String - Defaults to 'en-US' (Optional)

Examples

  // Pretty Print: Number  (2 places)'
>> FormatNumber(1000); // '1,000'


  // Pretty Print: Number  (1 place)'
>> FormatNumber(1234567.89, 1); // '1,234,567.9'


  // Pretty Print: Number  (0 places - Round)'
>> FormatNumber(22333.44, 0); // '22,333'

FormatPercent

Parameters

  • number: Number - Value to convert
  • precision: Number - Defaults to 2 (Optional)
  • locale: String - Defaults to 'en-US' (Optional)

Examples

  // Pretty Print: Percentage (2 places)'
>> FormatPercent(0.8522); // '85.22%'


  // Pretty Print: Percentage (Trailing 0)'
>> FormatPercent(0.135); // '13.50%'


  // Pretty Print: Percentage (1 place)'
>> FormatPercent(0.7337, 1); // '73.4%'


  // Pretty Print: Percentage (0 places - Round Up)'
>> FormatPercent(0.5567, 0); // '56%'


  // Pretty Print: Percentage (0 places - Round Down)
>> FormatPercent(0.3312, 0); // '33%'

Locale Support:

In the current version of num-format it should be assumed that only en-US formatting is supported as Node 8.x has limited locale support.


num-format uses Semantic Versioning. | Copyright © 2018 Chris Kilpatrick. Released under MIT License.

About

V. 0.1.1: Pretty Printer for Currency, Percentages, Numbers

Resources

License

Packages

No packages published