Package Exports

@isahaq/numbertostring
@isahaq/numbertostring/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@isahaq/numbertostring) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@isahaq/numbertostring

A powerful and flexible multilingual number-to-words converter supporting multiple languages with an easy-to-use API.

✨ Features

🌍 Multi-language support: English, Bangla, French, Urdu, Chinese, Hindi, and Spanish
🔢 Large number support: Handle numbers from zero to billions
💱 Currency formatting: Built-in currency conversion support
🎯 TypeScript support: Full type definitions included
⚡ Lightweight: Minimal dependencies and small bundle size
🛠️ Highly configurable: Customize output format to your needs

📦 Installation

npm install @isahaq/numbertostring

Or using yarn:

yarn add @isahaq/numbertostring

Or using pnpm:

pnpm add @isahaq/numbertostring

🎯 Quick Start

const NumberToString = require("@isahaq/numbertostring");
or;
import NumberToString from "@isahaq/numbertostring";

// Create an instance of the converter
const converter = new NumberToString();

// Convert numbers to different languages
console.log(converter.convertEn(12345)); // twelve thousand three hundred and forty five
console.log(converter.convertBn(12345)); // বারো হাজার তিন শত পঁয়তাল্লিশ
console.log(converter.convertFr(12345)); // douze mille trois cent quarante-cinq
console.log(converter.convertUr(12345)); // بارہ ہزار تین سو پینتالیس
console.log(converter.convertZh(12345)); // 一万二千三百四十五
console.log(converter.convertHi(12345)); // बारह हज़ार तीन सौ पैंतालीस
console.log(converter.convertEs(12345)); // doce mil trescientos cuarenta y cinco

🌐 Supported Languages

Language	Code	Example (42)
English	`en`	forty-two
Bangla	`bn`	বিয়াল্লিশ
French	`fr`	quarante-deux
Spanish	`es`	cuarenta y dos
Hindi	`hi`	बयालीस
Urdu	`ur`	بیالیس
Chinese	`zh`	四十二

⚙️ API Reference

`numberToWords(number, options)`

Converts a number to its word representation.

Parameters

number (number): The number to convert
options (object, optional): Configuration options
- language (string): Language code (default: 'en')
- currency (boolean): Format as currency (default: false)
- currencyUnit (string): Currency unit name
- titleCase (boolean): Capitalize first letter (default: false)
- ordinal (boolean): Convert to ordinal number (default: false)

Returns

(string): The number converted to words

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

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

👤 Author

Isahaq

GitHub: @isahaq1
npm: @isahaq

🙏 Acknowledgments

Thanks to all contributors who have helped with language translations
Inspired by similar number-to-words libraries

📊 Support

If you found this project helpful, please give it a ⭐️!

For issues and feature requests, please use the GitHub issue tracker.

Made with ❤️ by Isahaq