number-to-arabic-words

1.5.3 • Public • Published

npm version example workflow

Numbers To Arabic Words

is a library to transform the numbers into Arabic words without any external dependencies and it's so fast and stable because it's build in typescript.

Why do you Need to use it ?

  • Supporting Browser and NodeJs .
  • Easy installation .
  • Unlimited Updates and Support .
  • Made by 💖 to be Free forever .
  • Based on Arabic number rules Arabic Numbers Rules المعجم
  • Support points like that 100.52
  • Customizable 🎒💻
  • Support unlimited number length more than 100000000000000000000 "كوادرليون" 😲
  • Just only one function toArabicWord(1000) do this magic 👌

How To Install ?

Browser

<script src="https://cdn.jsdelivr.net/npm/number-to-arabic-words@latest/dist/index.js"></script>
<script>
    toArabicWord(1000)
</script>

Npm

    npm i number-to-arabic-words

Yarn

    yarn add number-to-arabic-words

NodeJs

const NumbersToArabicWords = require('dist/index-node.js')
NumbersToArabicWords.toArabicWord(1000)

Typescript

import { toArabicWord } from 'number-to-arabic-words/dist/index-node.js';
toArabicWord(1000);

React

Check this discussion How to use this library in Reactjs ? By @RedaTheCeo

Examples

Number Result
toArabicWord(1000) ألف
toArabicWord(100000) مائه ألف
toArabicWord(2000000) مليونان
toArabicWord(102030) مائه و أثنان ألف و ثلاثون
toArabicWord(5000.65) خمس آلاف فاصل خمس و ستون
toArabicWord(200.23) مائتان فاصل ثلاث و عشرون
toArabicWord(1.00) مائة فاصل تسع آلاف و خمسمائة و ثمان و ستون
toArabicWord(100.9568) مائة فاصل تسع آلاف و خمسمائة و ثمان و ستون
toArabicWord(100.52) مائه فاصل أثنان و خمسون

Advanced

  • You can change the config by using the global object arabicWord as example ..
arabicWord.setConfig({
    delimiter: '/',
    strict: true,
})

All the options

Option Type Description
1 delimiter string you can change instead of "فاصل" to be anything else
2 strict boolean get the result as Json
3 numberSectionsDelimiter string change "و" to be anything else

More

Docs

Please Let me know about any bug or feature and consider it done. Thank you 😍🚀💖 ..

Package Sidebar

Install

npm i number-to-arabic-words

Weekly Downloads

550

Version

1.5.3

License

MIT

Unpacked Size

69.3 kB

Total Files

9

Last publish

Collaborators

  • mahmoudshahin1111