Bridging Languages Through Number Translation – Supporting 10 Popular Languages.

num2talk Documentation

num2talk is a JavaScript package that provides functions to convert numbers into words in various languages, including English, Bengali, Hindi, Arabic, Chinese, Urdu, Portuguese, Russian, Japanese, and Spanish.

Installation

You can install num2talk via npm:

npm install num2talk

Usage

After installation, you can import the specific number-to-word functions you need in your project.

import { num2Word, num2Bangla, num2Hi } from 'num2talk';

// Example usage
console.log(num2Word(123));       // Converts to English words: "one hundred twenty-three"
console.log(num2Bangla(456));     // Converts to Bengali words: "চারশ পঁচাশি"
console.log(num2Hi(789));         // Converts to Hindi words: "सात सौ नवासी"

Language Functions Table

The following table outlines the available languages, their respective functions, and usage examples.

Language	Function	Usage Example	Output
English	num2English	num2English(12345)	"twelve thousand three hundred forty-five"
English	num2Words	num2Words(12345)	"twelve thousand three hundred forty-five"
Bengali	num2Bangla	num2Bangla(678)	"ছয়শ আটাত্তর"
Hindi	num2Hindi	num2Hindi(101)	"एक सौ एक"
Arabic	num2Arabic	num2Arabic(345)	"ثلاثمائة وخمسة وأربعون"
Chinese	num2Chinese	num2Chinese(5678)	"五千六百七十八"
Urdu	num2Urdu	num2Urdu(901)	"نو سو ایک"
Portuguese	num2Portuguese	num2Portuguese(2345)	"dois mil trezentos e quarenta e cinco"
Russian	num2Russian	num2Russian(890)	"восемьсот девяносто"
Japanese	num2Japanese	num2Japanese(1234)	"千二百三十四"
Spanish	num2Spanish	num2Spanish(567)	"quinientos sesenta y siete"

Example Usage

Here’s how to use some of the functions:

Using num2English

The num2English function takes a number as input and returns the corresponding English word.

import {num2Arabic, num2Bangla, num2Chinese, num2English, num2Hindi,num2Japanese, num2Portuguese, num2Russian, num2Spanish,num2Urdu} from 'num2talk'

const App = () => {
    const number = 12345

    console.log(num2English(number))
    console.log(num2Hindi(number))
    console.log(num2Japanese(number))
    console.log(num2Portuguese(number))
    console.log(num2Russian(number))
    console.log(num2Spanish(number))
    console.log(num2Urdu(number))
    console.log(num2Arabic(number))
    console.log(num2Bangla(number))
    console.log(num2Chinese(number))
  return (
    <div>App</div>
  )
}

export default App

Contributing

If you wish to contribute to the development of num2talk, feel free to fork the repository and submit pull requests. Ensure you follow the coding conventions and include tests for any new features you add.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• Thank you to all contributors and users for your support in improving this package.

---

Additional Sections (if needed)

• Changelog: Document any updates, fixes, or improvements made to the package over time.
• FAQ: Address common questions or issues users might encounter.
• Contributing: Provide instructions for how to contribute to the project.
• Credits: List any third-party libraries or resources used in the package.
• License: Include a copy of the license used for the package.