garora / number2text

Provides the facility to convert number to text (currently supports only Indian and English style for number to text including currency (Indian Rupee and US Dollar))

Looking for contributors

Due to other stuffs, I'm unable to maintain the repository. There were plans to enhance the code with new langauge/conversions, if you have time and willing to help communities. You are the one who can contribute. Add your plan here and lets start it.

Number to Text

Provides the facility to convert number to text.

• Default type is Indian for non-currency
• Default type is Indian Rupee for currency
• Indian style for number to text (Indian Rupee for currency)
• English style for number to text (US Dollar for currency)

How to install?

  npm install number2text

How to use?

  var numberToText = require('number2text');

     
  var textDefault = numberToText(1000000); //it converts to default type i.e. Indian

  console.log('Converts 1000000 to ', textDefault); //Converts 1000000 to Ten Lakh

       
  var textIndian = numberToText(1000000,'Indian');

  console.log('Converts 1000000 to ', textIndian); //Converts 1000000 to Ten Lakh

       
  var textEnglish = numberToText(1000000,'English');

  console.log('Converts 1000000 to ', textEnglish); //Converts 1000000 to One Million

       
  //Large values

  var textIndian = numberToText(1000000000000);
  var textEnglish = numberToText(1000000000000,'English');

  console.log('Converts 1000000000000 to ', textIndian); //Converts 1000000000000 to One Lakh Crore
  console.log('Converts 1000000000000 to ', textEnglish); //Converts 1000000000000 to One Trillion

       
  //For types other than Indian, English

  var text = numberToText(100,"French");
  
  console.log('Retuns message: ', text); //Return message: Support for language: french is not available. Available languages are: indian,english

       
  var defaultCurrency = numberToText(100.10,'',true);

  console.log('Converts 100.10 to ', defaultCurrency); //Converts 100.10 to One Hundred Rupee And Ten Paise Only

       
  var defaultNonCurrency = numberToText(100.10);

  console.log('Converts 100.10 to ', defaultNonCurrency); //Converts 100.10 to One Hundred Point Ten 

Executing tests

   npm test

Contribution

Just need to take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

  git clone https://github.com/garora/number2text.git
  cd number2text

Contributors

Many thanks to all the contributors who spent their time to write code. Their contribution is priceless, A small gratitude for their contributions:

1. Rishabh Desai

Starting with pre-release installation

  npm install git://github.com/garora/number2text.git
  npm install git://github.com/garora/number2text.git#pre-releaseversion

License

MIT

Release notes

Currently number2text is in initial release. We're trying to make it more stable. Currently, it supports Indian standard to read numbers as words. Check for more details: Change log

Release history

• 0.0.0 Initial release
• 0.1.0 Initial release - Fixed few issues related to build
• 0.1.1 Few fixes
• 0.1.11 Typos
• 1.0.0 New feature
• 1.0.1 Added large number support
• 1.1.0 Added currency support
• 1.1.1 typos

number2text's Issues

fourty should be forty

Build is failing

Build is failing due to failure of tests.