-
6.1 Numbers Mode
6.2 Currency Mode
6.3 Compact Mode
6.4 Tashkeel Mode (تشكيل الحروف)
6.5 Tanween Alif Type (نوع ألِف التنوين)
6.6 ʾIʿrāb Cases (حالات الإعراب (رفع، نصب، جر))
6.8 Miah Split (فصل المِائة عن الرقم)
6.9 Comma between Words (فاصلة بين الكلمات)
6.11 Arabic Numbers (أرقام عربية مشرقية)
6.12 Numbering System Scale (النظام العددي)
6.13 Maximum Number (أقصى رقم)
6.15 Decimal Separator (رمز الفاصل العشري)
6.16 Thousands Separator (رمز فاصل الآلاف)
6.17 Brackets Mode (نظام القوسين)
6.18 Brackets Type (اختيار نوع القوسين)
6.19 Number Symbol (رمز الرقم/علامة العملة)
6.20 Decimal Rounding
6.21 Decimal Formats (تنسيقات الكسور)
6.22 Decimals in Brackets (كسور بين قوسين)
6.23 Decimal Juzu
6.24 Decimal Fasilah (فاصلة عوضًا عن الواو)
6.25 Ignore Decimals (تجاهل الكسور)
6.26 Decimal AL (لام تعريف الكسر)
6.27 Ignore Country (تجاهل اسم البد)
6.28 Force Decimals in Currency
6.29 Prefix Text
6.30 Suffix Text
6.31 IsNaN String
Some time ago I felt that it was necessary to have a library that properly and correctly converts numbers (including all world currencies) into correct Arabic text that is free and available for all.
Many websites and programming libraries exist (in various programming languages) that attempt to convert numbers and currencies to Arabic text but many fail to do it properly in accordance with the correct Arabic language grammar, let alone provide the needed options, flexibilities, and facilities required. Many other utilities fail to handle large numbers or very small numbers correctly, let alone handle decimal parts of numbers.
For the above reasons, I had decided to code this library in the most used programming language (javascript) and make it available for all of us; which means you can use it at your front-end web page or back-end server.
I have chosen the name of the group libraries to be "arqam" which means "numbers" in Arabic.
This library is called arqamAR which means that it is for Arabic output text.
arqamAR is a JavaScript utility library part of the arqam Library Group that converts numbers and currencies into the equivalent Arabic text, taking into account the correct type of the counted subject's gender (مؤنث ومذكر) and other Arabic language grammar and styling rules therefore ensuring accuracy of the converted numbers and currencies in accordance with the Arabic grammar rules.
arqamAR ensures that you have no errors in writing numbers in words especially when writing cheques in Arabic !!
The arqamAR library provides the following functionalities and features in the Numbers Mode, the Currency Mode, and the Subjects Mode.
- arqamAR provides many Options for the display and formatting of the outputted Arabic Text which includes:
- Arabic output text in accordance with the Arabic grammar rules.
- Handles both numbers (Numbers Mode) and currencies (Currency Mode) with decimals and sub-units.
- Comes with 173 currencies including all current ISO currencies.
- Support full ʾIʿrāb (حالات الإعراب) الرفع والنصب والجر
- Support for 6 modes of tashkeel (تشكيل الحروف كاملاً أو جزئيّا).
- Support for full and partial Tanween (تنوين كامل).
- Provide the compact mode which is preferred by the press and newspapers (الكتابة المختصرة).
- Provide an Accountant Legal Mode (كتابة محاسبية قانونية).
- Provide thirty (30) formats and options for outputting Arabic text.
- Provide nine (9) additional options for display of Decimal Numbers.
- Provide the options for using the Arabic, Short, or Long Scale Numbering Systems.
- Handle extremely very large numbers up to 10^3000 in the Short Scale and 10^6000 in the Long Scale.
- Handle extremely very low decimal digits up to 10^3000 decimal digits.
- Provide an ability to easily add new additional currencies.
- Provide an ability to easily modify existing currencies.
- Provide a Subjects Mode to use other subjects (other than currencies) in the output text.
- Provide a batch process facility to process multiple numbers in one call.
A full list of all options is provided below.
arqamAR uses arqamAR.toWords() to convert a number to text. This will use the default configuration.
arqamAR.toWords(number | array [, ISO_code | {options} ])number: Number in Numeric or String form.
Large numbers and numbers with large decimals may be passed in a string form if required. It is advisable that numbers are passed inside quotes (as a string) especially large or very small decimals to prevent Javascript from converting them to e-notation numbers.
Numbers may be passed in Arabic-Eastern format (i.e. numbers ٠١٢٣٤٥٦٧٨٩) (as a string), if required.
Underscores may be used as separators in numeric literals (ES2021).
array: an array of number to be batch processed. See Batch Processing below for details.
⛔ arqamAR does not accept the exponent (e-notation) number formats.
The Second Parameter is optional and is used as a short-cut instead of the arqamAR.config().
The 2nd parameter may be:
-
ISO_Code : "String" a 3-letter ISO code in <string> form.
-
{options}: object {name:value} representing the options as required by
arqamAR.config().
An Arabic text string representation of the number or currency.
The various options and configuration can be set and changed using the arqamAR.config().
The configuration options provide full and flexible control of how the output text is formatted and displayed.
Once specific options are set, all subsequent calls to arqamAR.toWords() will use the already defined options. So the arqamAR.config() can be called only once at the start of your code.
Options can be changed at any time.
💡Important Note
Options are sticky in that they are remembered for the next call. For example:
arqamAR.toWords(20,"USD");will result in عشرون دولارًا أمريكيًا
If then you issue another line like:
arqamAR.toWords(30); // without any optionswill result in ثلاثون دولارًا أمريكيًا
because the option "USD" is remembered in the next call.
Example:
// Set the options to QAR Currency with Full Tashkeel and using Miah
arqamAR.config({Currency: "QAR", tashkeel: "f"});
let result = arqamAR.toWords(2500.35); // convert the number to currency text
console.log(result);
// ===== Output =======
ألْفانِ وَخَمْسُمَائَةِ رِيَالٍ قَطَرِيٍّ، وَخَمْسَةٌ وَثَلاثونَ دِرْهَمًا
arqamAR.config() provides full access to arqamAR configurations.
It is preferred to use the arqamAR.config() at the start of your code, and then simply use arqamAR.toWords() to process whatever numbers you like. This is also the fastest processing method.
However, rather than using the arqamAR.config(), arqamAR provides two (2) alternative methods of shortcut using the arqamAR.toWords() itself by using the second parameter of arqamAR.toWords(). See above for the arqamAR.toWords() syntax.
If the 2nd parameter of the arqamAR.toWords() function is a valid ISO Currency Code, then that code is used and a switch is made to the Currency Mode.
If the 2nd parameter in arqamAR.toWords() is an object then that is assumed to be a configuration option and is then decoded as is done for the arqamAR.config().
Example Shortcut to use the Currency Mode
// Shortcut to enter and use the Currency Mode
arqamAR.toWords(2200.2,"USD");
arqamAR.toWords(2200.2,"LBP");
arqamAR.toWords(2200.2,"EGP");
arqamAR.toWords(2200.2,"GBP");
arqamAR.toWords(2200.2,"JOD");
arqamAR.toWords(2200.2,"OMR");
arqamAR.toWords(2200.2,"KWD");
// ===== Output =======
ألفان ومائتا دولار أمريكي، وعشرون سنتًا
ألفان ومائتا ليرة لبنانية، وعشرون قرشًا
ألفان ومائتا جنيه مصري، وعشرون قرشًا
ألفان ومائتا جنيه إسترليني، وعشرون بنسًا
ألفان ومائتا دينار أردني، ومائتا فلس
ألفان ومائتا ريال عماني، ومائتا بيسة
ألفان ومائتا دينار كويتي، ومائتا فلس
Example Shortcut to change the Configurations
// Shortcut to change the configuration without using the arqamAR.config()
arqamAR.toWords(2200.2,{tashkeel:"f", code:"QAR", brackets: "end"});
arqamAR.toWords(3300.5,{tashkeel:"f", code:"AED", brackets: "end", arabicNumbers: "on"});
// ===== Output =======
(QAR 2,200٫20) ألْفانِ وَمَائَتا رِيَالٍ قَطَرِيٍّ، وَعِشْرونَ دِرْهَمًا
(AED ٢,٢٠٠٫٢٠) ألْفانِ وَمَائَتا دِرْهَمٍ إمَارَاتِيٍّ، وَعِشْرونَ فِلْسًا
💡 While arqamAR provides many options and configuration to use, the default settings are sufficient to handle the most used methods of converting numbers to words in Arabic.
💡 When displaying Arabic text inside fields or html 'div's, set the text direction to Righ-to-Left (RTL) for proper display especially when the text includes both Arabic and Latin characters.
💡 If you copy the output text to an MS Excel cell, set the cell format display to Righ-to-Left (RTL) using 'Format Cells, Alignment, Text direction: Right-to-Left
| No. | Configuration Option | Available Settings |
Default Setting |
Purpose |
|---|---|---|---|---|
| 1 | code | "" empty ISO code 'sub' |
"" empty | The 3-Letter ISO Code of the Currency. Specifying a valid currency-code will switch to the Currency Mode and generate the text for a currency taking into account the sub-currency. An empty "" string will switch to the Numbers Mode which is the default. 'sub' will enter the Subjects Mode. |
| 2 | compact | "on" "off" |
'off' | Use the Compact Mode. |
| 3 | tashkeel | "" "f" "p" "t" "h" "a" |
"a" | Selects the type of Tashkeel (تشكيل الحروف) with: 1. 'f' 'full tashkeel', 2. 'p' 'partial tashkeel', 3. 't' full tanween, 4. 'h' tansween fatih only. 5. 'a' tanween alif only 6. '' none at all. The default is 'a' (tanween alif) (تنوين ألِف فقط) |
| 4 | tanweenAlif | "on" "off" |
"off" | In the case of Tanween Fatih. Selects the placement of the tanween sign either on the charater before last (default), or on the last character. Examples: قرشًا مصريًا and دولارًا أمريكيًا with option 'on' becomes: قرشاً مصرياً and دولاراً أمريكياً |
| 5 | ierab | "r" "n" "j" |
"r" | Selects the ʾIʿrāb Type (حالة الإعراب) which can be any of the following: 1. 'r' (Raf') (Nominative Case) حالة الرفع, 2. 'n' (Nasb) (Accusative Case) حالة النصب, or 3. 'j' (Jar) (Genitive Case) حالة الجر. The default is Nominative Case (حالة الرفع). Examples: 'r' ➡️ سَبْعَةُ آلَافٍ وَثَلاثُمِائَةٍ وَواحِدٌ وَعِشْرونَ دِينَارًا كُوَيتِيًّا 'n'➡️ سَبْعَةَ آلَافٍ وَثَلاثَمِائَةٍ وَواحِدًا وَعِشْرينَ دِينَارًا كُوَيتِيًّا 'j' ➡️ سَبْعَةِ آلَافٍ وَثَلاثِمِائَةٍ وَواحِدٍ وَعِشْرينَ دِينَارًا كُوَيتِيًّا |
| 6 | miah | "on" "off" |
"on" | Selects between "مِئة" (off) and "مِائة" (on) style. Default is "on" showing "مِائة". |
| 7 | miahSplit | "on" "off" |
"off" | Use separation between number and hundred words (e.g. ثلاثمائة becomes ثلاث مائة). |
| 8 | comma | "on" "off" |
'off' | Insert a comma between the number triplet text for better readability of large numbers. |
| 9 | legal | "on" "off" |
'off' | Use the legal accounting mode; helpful to get the correct legal writing and avoid misinterpretation of written numbers. |
| 10 | arabicNumbers | "on" "off" |
'off' | Uses Arabic-Eastern numbers (٠١٢٣٤٥٦٧٨٩) in place of Arabic-Western numbers (0123456789). This will also set the appropriate Arabic decimal and thousand separators, unless overriden by the sepDecimal and sepThousands options. |
| 11 | scale | "arabic" "short" "long" |
"arabic" | Selects the Numbering Scale System. "arabic", "short", or "long" numbering scale system. The Default is the Arabic-Modified Short Scale Numbering System. See more details below. |
| 12 | maxNumber | <number> | 1000 | The maximum number in the form 10^n (i.e. the number of zeros on the right hand). Default up to 1,000 zeros for numbers. This can be up to 3,000 zeros. The maxNumber also sets the maximum number of decimal digits that can be translated to words. |
| 13 | addZero | "on" "off" |
'off' | Adds the word zero "صفر" for numbers below one (1). |
| 14 | sepDecimal | "" empty <string> lang tag |
"" empty | The decimal separator to use for display. Defaults to the system locale if "" empty. |
| 15 | sepThousands | "" empty <string> lang tag |
"" empty | The thousands separator to use for display. Defaults to the system locale if empty. |
| 16 | brackets | "" empty "start" "end" "decimal" |
"" empty | Adds the whole number (including any decimal parts) in digits form inside brackets either at the end of the text or at the start of the text, or to add only the Decimal Part in braclets at the end of the output text. Options are provided in the Currency Mode to add the currency ISO Code or the currency symbol/sign. Default: no number in bracket shown. The brackets character type can be controlled by the bracketsOpen and bracketsClose options.<br/The brackets type can be changed by the bracketsType option. |
| 17 | bracketsType | <string> empty |
"" empty | Change the brackets type from the default round brackets '()' to any other type such '[]' or '{}', etc. |
| 18 | numSymbol | <string> "" empty "iso" "symbol" "symbolL" "currency" |
"" empty | With the brackets option, controls the symbol/sign to be used when displaying currency numbers inside brackets. Available with the brackets and the Currency Mode options only. |
| 19 | decRound | number "" empty |
"" empty | The number of decimal places for rounding decimals. Default no rounding and all decimal digits will be converted to words. Available in Numbers Mode Only. In the Currency Mode, rounding is dictated by the minor unit decimals. |
| 20 | decFormat | "" empty "ww" "wn" "nw" "nn" "sw" "d" "/" "n" "w" |
"" empty | Controls the format of the decimal (fractional) part with nine (9) options. Defaults to "w" in the Currency Mode and to "ww" in the Numbers Mode. See below for more details and examples. |
| 21 | decJuz | "on" "off" |
'on' | The word "Juzu'" (جزء من) is used in the formation of the Decimal Part for the number. This is the default and is set to 'on'. |
| 22 | decFaslah | "on" "off" |
'off' | The word "fasila" (فاصلة) is used in the formation of the Decimal Part for the number instead of "Juzu" (جزء). The default is "Juzu" (جزء). |
| 23 | decIgnore | "on" "off" |
'off' | Ignores the Decimal Part of the number. |
| 24 | decAL | "on" "off" |
'on' | Default is 'on'. See details below. |
| 25 | ignoreCountry | "on" "off" |
'off' | Ignores the country name but keeps the currency name. Available in Currency Mode. |
| 26 | currDecForce | "on" "off" |
'off' | With the brackets option in the Currency Mode, forces the decimal (sub-unit) part to always be displayed, even when there is no decimal part. Available in the Currency Mode. |
| 27 | prefix | <string> | "" empty | Add a prefix text before the resulting output text. Default no prefix. |
| 28 | suffix | <string> | "" empty | Add a suffix text to the end of the resulting output text. Default no suffix. |
| 29 | isNaN | <string> | "" empty | The text to be returned if the number passed is not a valid number. Default is an empty string. |
| 30 | decSubInParts | 'on' | off | Applicable only, and used in the Subjects Mode in the case of compounded adjectives. See the Subjects Mode below. |
- An "off" setting of an option can be replaced with an empty string "". The "" has similar effect as "off".
- The words "on" or "off" can use any case such as "On", "ON", "Off", or "OFF".
- The ISO codes in the Currency Mode must be in block letters; i.e. USD, GBP, etc.
The Numbers Mode is the default arqamAR output mode. arqamAR will always start in the Numbers Mode by default.
In this mode, numbers in digit form are converted into Arabic text using various configuration formats.
Decimals Parts of the number are also converted into Arabic text with various output formats available.
The default output in the Numbers Mode is very simple and precise Arabic text; with an example below:
arqamAR.toWords(123);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
مائة وثلاثة وعشرون
مليونان وخمسمائة وستون ألفًا
ثلاثة ملايين وثلاثمائة وستة وخمسون ألفًا وسبعمائة وتسعة وثمانون
خمسة وعشرون، وسبعة وعشرون جزءًا من المئة
خمسة أجزاء من العشرة
خمسة وثلاثون جزءًا من المئة
If you were in the Currency Mode, you can switch back to the Numbers Mode by setting the arqamAR.config to (code : '') using the following line:
arqamAR.config({code : ''}).The Currency Mode is enabled by specifying a valid 3-letter ISO Currency Code using the configuration option arqamAR.config() {code: <ISO Code>.
The 3-letter ISO Code must be in block letters, for example : USD, GBP, KWD, QAR, JOD, EGP, etc.
An invalid ISO Code will not produce and error and arqamAR will first try to switch to the New Currency Mode expecting that it is a new currency to be created, but if that failed it will switch to the Numbers Mode. See below how to create a New Currency or Modify Existing Currency.
Almost all of the arqamAR configuration options are available in the Currency Mode.
In addition, there are specific arqamAR configuration options which only apply in the Currency Mode.
arqamAR recognises 173 currency codes (including the latest ISO-4217 codes) and has all necessary data settings for each currency. This includes the names of the major and minor currencies, the applicable country names, the decimal sub-units, and symbols/signs.
arqamAR.config({code : 'USD'});
arqamAR.toWords(20000);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
عشرون ألف دولار أمريكي
مليونان وخمسمائة وستون ألف دولار أمريكي
ثلاثة ملايين وثلاثمائة وستة وخمسون ألفًا وسبعمائة وتسعة وثمانون دولارًا أمريكيًا
خمسة وعشرون دولارًا أمريكيًا، وسبعة وعشرون سنتًا
خمسون سنتًا أمريكيًا
خمسة وثلاثون سنتًا أمريكيًا
The compact configuration option provides a unique output method that many newspapers and magazines prefer using for writing large numbers.
The compact output text is a combination of both digits and words.
- This option is available in both the Numbers Mode and the Currency Mode.
Examples in Numbers Mode:
//--------------------------
// Examples using Numbers
//--------------------------
arqamAR.config({ compact : "on" }); // enable compact mode
arqamAR.toWords(20200);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
20 ألفًا و200
مليونان و560 ألفًا
3 ملايين و356 ألفًا و789
25، و27 جزءًا من الـ100
5 أجزاء من الـ10
35 جزءًا من الـ100
Examples in Currency Mode:
//--------------------------
// Examples using Currencies
//--------------------------
arqamAR.config({ compact : "on" , code: "USD" }); // enable both compact and currency options
arqamAR.toWords(20200);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
20 ألفًا و200 دولار أمريكي
مليونان و560 ألف دولار أمريكي
3 ملايين و356 ألفًا و789 دولارًا أمريكيًا
25 دولارًا أمريكيًا، و27 سنتًا
50 سنتًا أمريكيًا
35 سنتًا أمريكيًا
Note: You will notice that the words "ألفان", "ألف", "مليون", "مليونان", etc. will not be converted into digit form as this will lead to incorrect Arabic grammar.
arqamAR provide six (6) options of tashkeel (تشكيل الحروف) namely
-
'' (none) No tashkeel.
-
"a" tanween alif only (تنوين حرف الألِف فقط)
-
'h' tansween fatih only (تنوين فتح فقط). This is the default,
-
't' full tanween (تنوين كامل : فتح ضم وكسر),
-
'p' 'partial tashkeel' (تشكيل جزئي بتشكيل آخر حرف من كل كلمة), or
-
'f' 'full tashkeel' (تشكيل كامل).
Examples:
-
"" (none) ➡️ ثلاثمائة وواحدا وخمسين ألفا وخمسة وخمسين جنيها مصريا
-
'a' ➡️ ثلاثمائة وواحدًا وخمسين ألفًا وخمسة وخمسين جنيهًا مصريًا
-
'h' ➡️ ثلاثمائة وواحدًا وخمسين ألفًا وخمسةً وخمسين جنيهًا مصريًا
-
't' ➡️ ثلاثمائةٍ وواحدًا وخمسين ألفًا وخمسةً وخمسين جنيهًا مصريًا
-
'p' ➡️ ثلاثَمائةٍ وواحدًا وخمسينَ ألفًا وخمسةً وخمسينَ جنيهًا مصريًا
-
'f' ➡️ ثَلاثَمِائَةٍ وَواحِدًا وَخَمْسينَ ألْفًا وَخَمْسَةً وَخَمْسينَ جُنَيْهًا مِصْرِيًّا
You will notice that each higher type of tashkeel includes the lower types of tashkeel.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
The following two (2) illustrations summarize the tashkeel options with output examples.
Examples in Numbers Mode:
//--------------------------
// Examples using Numbers
//--------------------------
arqamAR.config({ tashkeel : "f" }); // enable tashkeel option
arqamAR.toWords(20200);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
عِشْرونَ ألْفًا وَمَائَتَان
مِلْيُونانِ وَخَمْسُمَائَةٍ وَسِتّونَ ألْفًا
ثَلاثَةُ مَلَايينٍ وَثَلاثُمَائَةٍ وَسِتَّةٌ وَخَمْسونَ ألْفًا وَسَبْعُمَائَةٍ وَتِسْعَةٌ وَثَمَانون
خَمْسَةٌ وَعِشْرونَ، وَسَبْعَةٌ وَعِشْرونَ جُزءًا مِنَ المَائَة
خَمْسَةُ أجْزاءٍ مِنَ العَشرَة
خَمْسَةٌ وَثَلاثونَ جُزءًا مِنَ المَائَة
Example in Currency Mode:
//--------------------------
// Examples using Currencies
//--------------------------
arqamAR.config({ tashkeel: "f" code: "JOD"}); // enable both tashkeel and currency options
arqamAR.toWords(20200);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
عِشْرونَ ألْفًا وَمَائَتا دِينَارٍ أُردُنِيٍّ
مِلْيُونانِ وَخَمْسُمَائَةٍ وَسِتّونَ ألْفَ دِينَارٍ أُردُنِيٍّ
ثَلاثَةُ مَلَايينٍ وَثَلاثُمَائَةٍ وَسِتَّةٌ وَخَمْسونَ ألْفًا وَسَبْعُمَائَةٍ وَتِسْعَةٌ وَثَمَانونَ دِينَارًا أُردُنِيًّا
خَمْسَةٌ وَعِشْرونَ دِينَارًا أُردُنِيًّا، وَمَائَتَانِ وَسَبْعونَ فِلْسًا
خَمْسُمَائَةِ فِلْسٍ أُردُنِيٍّ
ثَلاثُمَائَةٍ وَخَمْسونَ فِلْسًا أُردُنِيًّا
Examples of Full Tanween:
- Tanween Fatih (تنوين الفتح): ألفًا جنيهًا دولارًا ريالًا خمسةً عشرةً
- Tanween Dhum (تنوين الضم): سبعةٌ خمسةٌ ستةٌ
- Tanween Kasr (تنوين الكسر): مئةٍ مائةٍ ألفٍ سبعمائةٍ بيسةٍ ليرةٍ
Examples of Full Tanween in Numbers Mode:
//--------------------------
// Examples using Numbers
//--------------------------
arqamAR.config({ tashkeel : "t" }); // enable tanween option
arqamAR.toWords(20200);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
عشرون ألفًا ومائتان
مليونان وخمسمائةٍ وستون ألفًا
ثلاثة ملايينٍ وثلاثمائةٍ وستةٌ وخمسون ألفًا وسبعمائةٍ وتسعةٌ وثمانون
خمسةٌ وعشرون، وسبعةٌ وعشرون جزءًا من المائة
خمسة أجزاء من العشرة
خمسةٌ وثلاثون جزءًا من المائة
Example of Full Tanween in Currency Mode:
//--------------------------
// Examples using Currencies
//--------------------------
arqamAR.config({ tashkeel : "t", code: "EGP"}); // enable both full tanween and currency options
arqamAR.toWords(20200);
arqamAR.toWords(2560000);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.5);
arqamAR.toWords(0.35);
// ===== Output =======
عشرون ألفًا ومائتا جنيهٍ مصريٍ
مليونان وخمسمائةٍ وستون ألف جنيهٍ مصريٍ
ثلاثة ملايينٍ وثلاثمائةٍ وستةٌ وخمسون ألفًا وسبعمائةٍ وتسعةٌ وثمانون جنيهًا مصريًا
خمسةٌ وعشرون جنيهًا مصريًا، وسبعةٌ وعشرون قرشًا
خمسون قرشًا مصريًا
خمسةٌ وثلاثون قرشًا مصريًا
Examples of Tanween Fatih Only in the Numbers Mode:
//--------------------------
// Examples using Numbers
//--------------------------
arqamAR.config({ tashkeel : "h"}); // enable tanween fatih only
arqamAR.toWords(20200);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.35);
// ===== Output =======
عشرون ألفًا ومائتان
ثلاثة ملايين وثلاثمائة وستة وخمسون ألفًا وسبعمائة وتسعة وثمانون
خمسة وعشرون، وسبعة وعشرون جزءًا من المائة
خمسة وثلاثون جزءًا من المائةExample of Tanween Fatih Only in the Currency Mode:
//--------------------------
// Examples using Currencies
//--------------------------
arqamAR.config({ tashkeel : "h", code: "KWD"}); // enable both tanween fatih and currency options
arqamAR.toWords(20200);
arqamAR.toWords(3356789);
arqamAR.toWords(25.27);
arqamAR.toWords(0.35);
// ===== Output =======
عشرون ألفًا ومائتا دينار كويتي
ثلاثة ملايين وثلاثمائة وستة وخمسون ألفًا وسبعمائة وتسعة وثمانون دينارًا كويتيًا
خمسة وعشرون دينارًا كويتيًا، ومائتان وسبعون فلسًا
ثلاثمائة وخمسون فلسًا كويتيًاThis option permits the choice of where tanween alif sign (حركة أو شكل تنوين الفتح) in case of the additional 'alif' is used (في حال استخدام حرف ألٍف العوض).
Some prefer it to be on the 'alif' and others prefer it to be on the character itself (i.e. before the 'alif').
Examples of the Default output:
ألفًا فلسًا دينارًا قرشًا مصريًا دولارًا
With this option "on" {tanweenAlif : 'on'} this becomes:
ألفاً فلساً ديناراً قرشاً مصرياً دولاراً
Applicability
- This option is available whenever any of the Tashkeel Mode options is enabled.
The {ierab: ""} selects the ʾIʿrāb Type (حالة الإعراب) which can be any of the following:
-
'r' (Raf') (Nominative Case) حالة الرفع,
-
'n' (Nasb) (Accusative Case) حالة النصب, or
-
'j' (Jar) (Genitive Case) حالة الجر.
The default arqamAR ouput is the Nominative case (حالة الرفع).
When using this option, the output text can be produced in any of the ʾIʿrāb Cases.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
The following examples will demonstrate the use of the {ierab: ""} option using full tashkeel for better presentation as it is sometimes difficult to differentiate between the Nasb and Jar without tashkeel.
Example 1 (Raf' Case) حالة الرفع
arqamAR.config({ ierab: "r", tashkeel: "f"}); // Select Raf' (إعراب رفع) with full tashkeel (تشكيل كامل)
console.log(arqamAR.toWords(5321)); // convert normal numbers
console.log(arqamAR.toWords(32112));
console.log(arqamAR.toWords(12012));
console.log(arqamAR.toWords(88888));
arqamAR.config({code:"EGP"}); // convert male currency numbers
console.log(arqamAR.toWords(521.34));
console.log(arqamAR.toWords(3212.02));
console.log(arqamAR.toWords(1212.23));
console.log(arqamAR.toWords(8088.11));
arqamAR.config({code:"LBP"}); // convert female currency numbers
console.log(arqamAR.toWords(521.34));
console.log(arqamAR.toWords(3212.02));
console.log(arqamAR.toWords(1212.23));
console.log(arqamAR.toWords(8088.11));
//======= Output ========
خَمْسَةِ آلَافٍ وَثَلاثِمِائَةٍ وَواحِدٍ وَعِشْرينَ
اثْنَيْنِ وَثَلاثينَ ألْفًا وَمِائَةٍ وَاثْنَي عَشَرَ
اثْنَي عَشَرَ ألْفًا وَاثْنَي عَشَرَ
ثَمَانِيَةٍ وَثَمَانينَ ألْفًا وَثَمَانِمِائَةٍ وَثَمَانِيَةٍ وَثَمَانينَ
خَمْسِمِائَةٍ وَواحِدٍ وَعِشْرينَ جُنَيْهًا مِصْرِيًّا، وَأرْبَعَةٍ وَثَلاثينَ قِرْشًا
ثَلاثَةِ آلَافٍ وَمِائَتَيْنِ وَاثْنَي عَشَرَ جُنَيْهًا مِصْرِيًّا، وَقِرْشَيْنِ اثْنَيْنِ
ألْفٍ وَمِائَتَيْنِ وَاثْنَي عَشَرَ جُنَيْهًا مِصْرِيًّا، وَثَلاثَةٍ وَعِشْرينَ قِرْشًا
ثَمَانِيَةِ آلَافٍ وَثَمَانِيَةٍ وَثَمَانينَ جُنَيْهًا مِصْرِيًّا، وَأحَدَ عَشَرَ قِرْشًا
خَمْسِمِائَةٍ وَإحْدَىَ وَعِشْرينَ لِيرَةً لُبْنَانِيَّةً، وَأرْبَعَةٍ وَثَلاثينَ قِرْشًا
ثَلاثَةِ آلَافٍ وَمِائَتَيْنِ وَاثْنَتَي عَشَرَةَ لِيرَةً لُبْنَانِيَّةً، وَقِرْشَيْنِ اثْنَيْنِ
ألْفٍ وَمِائَتَيْنِ وَاثْنَتَي عَشَرَةَ لِيرَةً لُبْنَانِيَّةً، وَثَلاثَةٍ وَعِشْرينَ قِرْشًا
ثَمَانِيَةِ آلَافٍ وَثَمَانٍ وَثَمَانينَ لِيرَةً لُبْنَانِيَّةً، وَأحَدَ عَشَرَ قِرْشًا
Example 2 (Nasb Case) حالة النصب
arqamAR.config({ ierab: "n", tashkeel: "f"}); // Select Nasb (إعراب نصب) with full tashkeel (تشكيل كامل)
console.log(arqamAR.toWords(5321)); // convert normal numbers
console.log(arqamAR.toWords(32112));
console.log(arqamAR.toWords(12012));
console.log(arqamAR.toWords(88888));
arqamAR.config({code:"EGP"}); // convert male currency numbers
console.log(arqamAR.toWords(521.34));
console.log(arqamAR.toWords(3212.02));
console.log(arqamAR.toWords(1212.23));
console.log(arqamAR.toWords(8088.11));
arqamAR.config({code:"LBP"}); // convert female currency numbers
console.log(arqamAR.toWords(521.34));
console.log(arqamAR.toWords(3212.02));
console.log(arqamAR.toWords(1212.23));
console.log(arqamAR.toWords(8088.11));
//======= Output ========
خَمْسَةَ آلَافٍ وَثَلاثَمِائَةٍ وَواحِدًا وَعِشْرينَ
اثْنَيْنِ وَثَلاثينَ ألْفًا وَمِائَةً وَاثْنَي عَشَرَ
اثْنَي عَشَرَ ألْفًا وَاثْنَي عَشَرَ
ثَمَانِيَةً وَثَمَانينَ ألْفًا وَثَمَانِمِائَةٍ وَثَمَانِيَةً وَثَمَانينَ
خَمْسَمِائَةٍ وَواحِدًا وَعِشْرينَ جُنَيْهًا مِصْرِيًّا، وَأرْبَعَةً وَثَلاثينَ قِرْشًا
ثَلاثَةَ آلَافٍ وَمِائَتَيْنِ وَاثْنَي عَشَرَ جُنَيْهًا مِصْرِيًّا، وَقِرْشَيْنِ اثْنَيْنِ
ألْفً وَمِائَتَيْنِ وَاثْنَي عَشَرَ جُنَيْهًا مِصْرِيًّا، وَثَلاثَةً وَعِشْرينَ قِرْشًا
ثَمَانِيَةَ آلَافٍ وَثَمَانِيَةً وَثَمَانينَ جُنَيْهًا مِصْرِيًّا، وَأحَدَ عَشَرَ قِرْشًا
خَمْسَمِائَةٍ وَإحْدَىَ وَعِشْرينَ لِيرَةً لُبْنَانِيَّةً، وَأرْبَعَةً وَثَلاثينَ قِرْشًا
ثَلاثَةَ آلَافٍ وَمِائَتَيْنِ وَاثْنَتَي عَشَرَةَ لِيرَةً لُبْنَانِيَّةً، وَقِرْشَيْنِ اثْنَيْنِ
ألْفً وَمِائَتَيْنِ وَاثْنَتَي عَشَرَةَ لِيرَةً لُبْنَانِيَّةً، وَثَلاثَةً وَعِشْرينَ قِرْشًا
ثَمَانِيَةِ آلَافٍ وَثَمَانيًا وَثَمَانينَ لِيرَةً لُبْنَانِيَّةً، وَأحَدَ عَشَرَ قِرْشًا
Example 3 (Jar Case) حالة الجر
arqamAR.config({ ierab: "j", tashkeel: "f"}); // Select Jar (إعراب جر) with full tashkeel (تشكيل كامل)
console.log(arqamAR.toWords(5321)); // convert normal numbers
console.log(arqamAR.toWords(32112));
console.log(arqamAR.toWords(12012));
console.log(arqamAR.toWords(88888));
arqamAR.config({code:"EGP"}); // convert male currency numbers
console.log(arqamAR.toWords(521.34));
console.log(arqamAR.toWords(3212.02));
console.log(arqamAR.toWords(1212.23));
console.log(arqamAR.toWords(8088.11));
arqamAR.config({code:"LBP"}); // convert female currency numbers
console.log(arqamAR.toWords(521.34));
console.log(arqamAR.toWords(3212.02));
console.log(arqamAR.toWords(1212.23));
console.log(arqamAR.toWords(8088.11));
//======= Output ========
خَمْسَةِ آلَافٍ وَثَلاثِمِائَةٍ وَواحِدٍ وَعِشْرينَ
اثْنَيْنِ وَثَلاثينَ ألْفًا وَمِائَةٍ وَاثْنَي عَشَرَ
اثْنَي عَشَرَ ألْفًا وَاثْنَي عَشَرَ
ثَمَانِيَةٍ وَثَمَانينَ ألْفًا وَثَمَانِمِائَةٍ وَثَمَانِيَةٍ وَثَمَانينَ
خَمْسِمِائَةٍ وَواحِدٍ وَعِشْرينَ جُنَيْهًا مِصْرِيًّا، وَأرْبَعَةٍ وَثَلاثينَ قِرْشًا
ثَلاثَةِ آلَافٍ وَمِائَتَيْنِ وَاثْنَي عَشَرَ جُنَيْهًا مِصْرِيًّا، وَقِرْشَيْنِ اثْنَيْنِ
ألْفٍ وَمِائَتَيْنِ وَاثْنَي عَشَرَ جُنَيْهًا مِصْرِيًّا، وَثَلاثَةٍ وَعِشْرينَ قِرْشًا
ثَمَانِيَةِ آلَافٍ وَثَمَانِيَةٍ وَثَمَانينَ جُنَيْهًا مِصْرِيًّا، وَأحَدَ عَشَرَ قِرْشًا
خَمْسِمِائَةٍ وَإحْدَىَ وَعِشْرينَ لِيرَةً لُبْنَانِيَّةً، وَأرْبَعَةٍ وَثَلاثينَ قِرْشًا
ثَلاثَةِ آلَافٍ وَمِائَتَيْنِ وَاثْنَتَي عَشَرَةَ لِيرَةً لُبْنَانِيَّةً، وَقِرْشَيْنِ اثْنَيْنِ
ألْفٍ وَمِائَتَيْنِ وَاثْنَتَي عَشَرَةَ لِيرَةً لُبْنَانِيَّةً، وَثَلاثَةٍ وَعِشْرينَ قِرْشًا
ثَمَانِيَةِ آلَافٍ وَثَمَانٍ وَثَمَانينَ لِيرَةً لُبْنَانِيَّةً، وَأحَدَ عَشَرَ قِرْشًا
Many Arabic-speaking countries' official documents prefer the use of the word "مِئة".
⛔ However, it must be noted that when using the word 'مِائة', it must still be read and pronounced the same as 'مِئة'. Fo this reason you should note the tashkeel on the letter 'ميم' is the same in both cases.
Please more reference information here.
This option affects all places where the word "مِئة" (hundred) is used.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
Examples with both the default and with the option {miah: "on"}:
Example with the default option "on":
arqamAR.toWords(300);
arqamAR.toWords(2500);
arqamAR.toWords(700900.02);
//======= Output ========
ثلاثمائة
ألفان وخمسمائة
سبعمائة ألف وتسعمائة، وجزءان اثنان من المائةExample with the option "off":
arqamAR.config({ miah: "off"}); // use default miah option
arqamAR.toWords(300);
arqamAR.toWords(2500);
arqamAR.toWords(700900.02);
//======= Output ========
ثلاثمئة
ألفان وخمسمئة
سبعمئة ألف وتسعمئة، وجزءان اثنان من المئة
This option permits the splitting/separation of the unit name from the hundred words.
Some Arabic-speaking countries consider this to be the correct method for writing the numbers from 300 to 900. The "ثلاثمِائة" becomes "ثلاث مِائة" and "أربعمِائة" becomes "أربع مِائة", and so on.
When combined with the option {miah: "off"}, this option produces the combined result of (for example) "ثلاث مِئة" and "أربع مِئة".
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
The flowing diagram illustrates the effect of this option:
Example with split the default "miah" option:
arqamAR.config({ miahSplit: "on"}); // enable miahSplit option
arqamAR.toWords(300);
arqamAR.toWords(2500);
arqamAR.toWords(700900.02);
//======= Output ========
ثلاث مائة
ألفان وخمس مائة
سبع مائة ألف وتسع مائة، وجزءان اثنان من المائةExample with split the "miah" option "off":
arqamAR.config({ miah: "off", miahSplit: "on"}); // enable miahSplit option with default miah option
arqamAR.toWords(300);
arqamAR.toWords(2500);
arqamAR.toWords(700900.02);
//======= Output ========
ثلاث مئة
ألفان وخمس مئة
سبع مئة ألف وتسع مئة، وجزءان اثنان من المئة
This option adds a comma "،" between the triplet number strings. This assists in having a more readable and better-interpreted text, especially for large numbers.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
The following are examples with both the default and with the option {comma: "on"}:
Examples:
//------------------------------------
// Examples with the 'comma' option on
//------------------------------------
arqamAR.config({ comma: "on"}); // enable comma option
arqamAR.toWords(12003050200);
arqamAR.toWords(700900);
//======= Output ========
اثنا عشر مليارًا، وثلاثة ملايين، وخمسون ألفًا، ومائتان
سبعمائة ألف، وتسعمائة
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
Consider the following examples:
arqamAR.toWords(101,000); // "مائة وألف"
arqamAR.toWords(102,010); // "مائة وألفان وعشرة"In the above examples, the output "مائة وألف" could be interpreted to mean 100 plus 1000 giving a total of 1,100. This of courses is not what is intended; what is intended is 101,000.
Similarly, the second example could be interpreted to mean 100 + 2000 + 10 giving a total 2,110 instead of meaning 102,010.
The above situations are unacceptable when writing legal or official documents (especially when writing cheque books). It is a common legal practice that where there exists an ambiguity or a dispute in the interpretation of a number, then the number in words overrides the number in figures. Therefore, the words must be clear and unambiguous.
This option permits such situations of ambiguity to be avoided.
The above examples can ne re-done with the option {legal: "on"}:
arqamAR.config({ legal: "on"}); // enable legal option
arqamAR.toWords(101000); // "مائة ألف وألف"
arqamAR.toWords(102010); // "مائة ألف وألفان وعشرة"💡 As additional protection against any ambiguity, it is advisable to enable the option {comma: "on"} to clearly indicate the separation between triplets.
The arabicNumbers option outputs digits in the Arabic-Eastern form (٠١٢٣٤٥٦٧٨٩) rather than the Arabic-Western form (0123456789).
Digits are displayed when any of the following options are used:
compactoption.bracketsoption, anddecFormatoption that displays digits ('wn', 'nw', 'nn', 'n', '/', or 'd')
With the {arabicNumbers: 'on', the Arabic-Western numbers (0123456789) are replaced with the Arabic-Eastern numbers (٠١٢٣٤٥٦٧٨٩).
Example with the option {compact:'on'}:
//-------------------------------------
// Examples with the `compact` option
//-------------------------------------
arqamAR.config({ compact: "on", arabicNumbers: "on"}); // enable arabicNumbers with compact option
arqamAR.toWords(5299530);
arqamAR.toWords(1560);
arqamAR.toWords(33.2);
// ===== Output =======
٥ ملايين و٢٩٩ ألفًا و٥٣٠
ألف و٥٦٠
٣٣، وجزءان ٢ من الـ١٠
Example with the option {brackets:'end'}:
//--------------------------------------
// Examples with the `brackets` option
//--------------------------------------
arqamAR.config({ brackets: "end", arabicNumbers: "on"}); // enable arabicNumbers with brackets option
arqamAR.toWords(5530);
arqamAR.toWords(1560);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
(٥٬٥٣٠) خمسة آلاف وخمسمائة وثلاثون
(١٬٥٦٠) ألف وخمسمائة وستون
(٣٣٫٢) ثلاثة وثلاثون، وجزءان اثنان من العشرة
(JOD ٥٬٥٣٠٫٩٨٠) خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، وتسعمائة وثمانون فلسًا
(BHD ١٬٥٦٠٫٤٥٠) ألف وخمسمائة وستون دينارًا بحرينيًا، وأربعمائة وخمسون فلسًا
(SDG ٣٣٫٢٠) ثلاثة وثلاثون جنيهًا سودانيًا، وعشرون قرشًا
Example with the option {decFormat:'nn'}:
//-------------------------------------------
// Examples with the decFormat:'nn' option
//-------------------------------------------
arqamAR.config({ decFormat: "nn", arabicNumbers: "on"}); // enable arabicNumbers with decFormat:'nn' option
arqamAR.toWords(5530.98);
arqamAR.toWords(1560.45);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
خمسة آلاف وخمسمائة وثلاثون، و٩٨ جزءًا من الـ١٠٠
ألف وخمسمائة وستون، و٤٥ جزءًا من الـ١٠٠
ثلاثة وثلاثون، وجزءان ٢ من الـ١٠
خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، و٩٨٠ جزءًا من الـ١٬٠٠٠ دينار
ألف وخمسمائة وستون دينارًا بحرينيًا، و٤٥٠ جزءًا من الـ١٬٠٠٠ دينار
ثلاثة وثلاثون جنيهًا سودانيًا، و٢٠ جزءًا من الـ١٠٠ جنيه
Example with the option {decFormat:'wn'}:
//-------------------------------------------
// Examples with the decFormat:'wn' option
//-------------------------------------------
arqamAR.config({ decFormat: "wn", arabicNumbers: "on"}); // enable arabicNumbers with decFormat:'wn' option
arqamAR.toWords(5530.98);
arqamAR.toWords(1560.45);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
خمسة آلاف وخمسمائة وثلاثون، وثمانية وتسعون جزءًا من الـ١٠٠
ألف وخمسمائة وستون، وخمسة وأربعون جزءًا من الـ١٠٠
ثلاثة وثلاثون، وجزءان اثنان من الـ١٠
خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، وتسعمائة وثمانون جزءًا من الـ١٬٠٠٠ دينار
ألف وخمسمائة وستون دينارًا بحرينيًا، وأربعمائة وخمسون جزءًا من الـ١٬٠٠٠ دينار
ثلاثة وثلاثون جنيهًا سودانيًا، وعشرون جزءًا من الـ١٠٠ جنيه
Example with the option {decFormat:'nw'}:
//-------------------------------------------
// Examples with the decFormat:'nw' option
//-------------------------------------------
arqamAR.config({ decFormat: "nw", arabicNumbers: "on"}); // enable arabicNumbers with decFormat:'nw' option
arqamAR.toWords(5530.98);
arqamAR.toWords(1560.45);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
خمسة آلاف وخمسمائة وثلاثون، و٩٨ جزءًا من المائة
ألف وخمسمائة وستون، و٤٥ جزءًا من المائة
ثلاثة وثلاثون، وجزءان ٢ من العشرة
خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، و٩٨٠ جزءًا من الألف دينار
ألف وخمسمائة وستون دينارًا بحرينيًا، و٤٥٠ جزءًا من الألف دينار
ثلاثة وثلاثون جنيهًا سودانيًا، و٢٠ جزءًا من المائة جنيه
Example with the option {decFormat:'n'}:
//-------------------------------------------
// Examples with the decFormat:'n' option
//-------------------------------------------
arqamAR.config({ decFormat: "n", arabicNumbers: "on"}); // enable arabicNumbers with decFormat:'n' option
arqamAR.toWords(5530.98);
arqamAR.toWords(1560.45);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
خمسة آلاف وخمسمائة وثلاثون، فاصلة ٩٨
ألف وخمسمائة وستون، فاصلة ٤٥
ثلاثة وثلاثون، فاصلة ٢
خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، و٩٨٠ فلسًا
ألف وخمسمائة وستون دينارًا بحرينيًا، و٤٥٠ فلسًا
ثلاثة وثلاثون جنيهًا سودانيًا، و٢٠ قرشًا
Example with the option {decFormat:'d'}:
//-------------------------------------------
// Examples with the decFormat:'d' option
//-------------------------------------------
arqamAR.config({ decFormat: "d", arabicNumbers: "on"}); // enable arabicNumbers with decFormat:'d' option
arqamAR.toWords(5530.98);
arqamAR.toWords(1560.45);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
خمسة آلاف وخمسمائة وثلاثون، و٠٫٩٨
ألف وخمسمائة وستون، و٠٫٤٥
ثلاثة وثلاثون، و٠٫٢
خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، و٠٫٩٨٠ دينار
ألف وخمسمائة وستون دينارًا بحرينيًا، و٠٫٤٥٠ دينار
ثلاثة وثلاثون جنيهًا سودانيًا، و٠٫٢٠ جنيه
Example with the option {decFormat:'/'}:
//-------------------------------------------
// Examples with the decFormat:'/' option
//-------------------------------------------
arqamAR.config({ decFormat: "/", arabicNumbers: "on"}); // enable arabicNumbers with decFormat:'/' option
arqamAR.toWords(5530.98);
arqamAR.toWords(1560.45);
arqamAR.toWords(33.2);
arqamAR.toWords(5530.98,"JOD");
arqamAR.toWords(1560.45,"BHD");
arqamAR.toWords(33.2,"SDG");
// ===== Output =======
خمسة آلاف وخمسمائة وثلاثون، و٩٨/١٠٠
ألف وخمسمائة وستون، و٤٥/١٠٠
ثلاثة وثلاثون، و٢/١٠
خمسة آلاف وخمسمائة وثلاثون دينارًا أردنيًا، و٩٨٠/١٬٠٠٠ دينار
ألف وخمسمائة وستون دينارًا بحرينيًا، و٤٥٠/١٬٠٠٠ دينار
ثلاثة وثلاثون جنيهًا سودانيًا، و٢٠/١٠٠ جنيه
💡 When displaying Arabic text inside fields or html 'div's, set the text direction to Right-to-Left (RTL) for proper display especially when the text includes both Arabic and Latin characters.
💡 If you copy the output text to an MS Excel cell, set the cell format display to Right-to-Left (RTL) using 'Format Cells, Alignment, Text direction: Right-to-Left
This scale option permits the selection of the Numbering System.
There are tree (3) Numbering Systems:
arabicArabic Numbering System. Is a modified Short Scale Numbering System (commonly used in Arabic countries except Saudi Arabia and the UA). This is the Default ued by arqamAR.shortThe Short Scale Numbering system (UK, USA, ans most English-speaking countries using the word Billion for the number 10^9).longThe Long Scale Numbering system. Used in most Europe and french speaking countries.
Notes:
💡 The Arabic Short Scale System is an exact Short Scale System except that the word Billion (بليون) at position 10^9 is replaced with the word milyar (مليار) (all other scale names remain unchanged).
💡 Most Arabic-language countries and regions use the modified Short Scale Numbering System (Arabic Numbering System) with 10^9 being مليار (milyar), except for a few countries like Saudi Arabia and the UAE which use the official Short-Scale System.
More information on countries using the system can be found here on Wikipedia: Arabic_Speaking_Long_and_Short_Scales.
The following diagram illustrates the difference between the three (3) systems:
Examples:
//-------------------------------------
// Examples with the `compact` option
//-------------------------------------
arqamAR.config({ compact: "on"}); // used compact mode for better comparison readability
arqamAR.toWords("1100100100100100000"); // default arabic scale
arqamAR.toWords("1100100100100100000" {scale : "short"}); // short scale
arqamAR.toWords("1100100100100100000" {scale : "long"}); // short scale
// ===== Output =======
كوينتليون و100 كوادرليون و100 ترليون و100 مليار و100 مليون و100 ألف // default arabic scale
كوينتليون و100 كوادرليون و100 ترليون و100 بليون و100 مليون و100 ألف // short scale
ترليون و100 بليار و100 بليون و100 مليار و100 مليون و100 ألف // short scaleNoe the change of the word "مليار" to "بليون" under the short scale numbering system.
Note 1: In the above example, the compact mode is used for easier readability and comparison.
Note 2: Large numbers are passed as a string.
Set the maximum number that can be used by arqamAR.
The default is 10^1000 (i.e. 100 مائة دِيْوْتْرِيجِنْتاترِسِنْتِلْيون).
The Largest number that can be converted by arqamAR is:
- مائة نُوفِنوناجِنْتانونْجِنْتِلْيون which is (10^3002) under the Short Scale System, and
- مائة نُوفِنوناجِنْتانونْجِنْتِلْيَارات which is (10^6000) under the Long Scale System.
💡 Note: Increasing the Decimal Rounding using the {decRound} above the Maximum Number will also increase the maximum number so that large decimal places are correctly converted.
💡 Only change the default number if you want to work with extremely very large numbers. Which is always not necessary.
Adds the word zero "صفر" for numbers below one (1).
By default, numbers below zero (i.e. with only Decimal Parts) will have their Decimal Parts only converted to text.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
Examples in the Numbers Mode:
arqamAR.toWords(0.5);
arqamAR.toWords(0.01);
arqamAR.toWords(0.2);
arqamAR.toWords(0.5,{addZero:"on"}); // option on
arqamAR.toWords(0.01,{addZero:"on"}); // option on
arqamAR.toWords(0.2,{addZero:"on"}); // option on
// ===== Output =======
خمسة أجزاء من العشرة
جزء واحد من المائة
جزءان اثنان من العشرة
صفر، وخمسة أجزاء من العشرة // option on 'صفر' added
صفر، وجزء واحد من المائة // option on 'صفر' added
صفر، وجزءان اثنان من العشرة // option on 'صفر' addedExamples in the Currency Mode:
arqamAR.toWords(0.5, {code:"USD"});
arqamAR.toWords(0.01,{code:"USD"});
arqamAR.toWords(0.2, {code:"USD"});
arqamAR.toWords(0.5, {code:"USD", addZero:"on"}); // option on
arqamAR.toWords(0.01,{code:"USD", addZero:"on"}); // option on
arqamAR.toWords(0.2, {code:"USD", addZero:"on"}); // option on
// ===== Output =======
خمسون سنتًا أمريكيًا
سنت أمريكي واحد
عشرون سنتًا أمريكيًا
صفر دولار أمريكي، وخمسون سنتًا // option on
صفر دولار أمريكي، وسنت واحد // option on
صفر دولار أمريكي، وعشرون سنتًا // option onWhen options are used for displaying numbers in digits inside brackets, arqamAR uses the system locale setting for displaying the Decimal Separator by default.
You can use this option to change the charatrer used by arqamAR for the Decimal Separator irrespective of the system locale.
The character may be any type or may be a BCP 47 language tag.
In the Arabic Numbers Mode, if no specific Decimal Separator is specified using this option, then the Decimal Separator is automatically set to ٫ (Unicode U+066B) by default.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
Examples:
{sepDecimal : ""} : Default uses the system locale as the Decimal Separator.
{sepDecimal : ","} : Uses comma (,) as the Decimal Separator.
// Examples
100,20
230,1
10,3{sepDecimal : "'"} : Uses apostrophe (') as the Decimal Separator.
// Examples
100'20
230'1
10'3{sepDecimal : "•"} : Uses dot symbol (•) as the Decimal Separator.
// Examples
100•20
230•1
10•3{sepDecimal : "en"} : Uses the BCP 47 language tag 'en' (English) as the Decimal Separator.
// Examples
100.20
230.1
10.3{sepDecimal : "ar-sa"} : Uses the BCP 47 language tag 'ar-sa' (Arabic-Saudia) as the Decimal Separator.
// Examples
100٫20
230٫1
10٫3{sepDecimal : "fr"} : Uses the BCP 47 language tag 'fr' (French) as the Decimal Separator.
// Examples
100,20
230,1
10,3⚠ Note 1: If the BCP 47 language tag is invalid, then the system locale setting is used.
⚠ Note 2: While it is possible to set both the Thousands Separator and the Decimal Separator to different BCP 47 language tags, it is recommended when using a BCP 47 language tag to use the same language tag for both the Thousands Separator and the Decimal Separator.
When options are used for displaying numbers in digits inside brackets, arqamAR uses the system locale setting for displaying the Thousand Separator by default.
You can use this option to change the charatrer for the Thousands Separator irrespective of the system locale.
The character may be any type or may be a BCP 47 language tag.
In the Arabic Numbers Mode, if no specific Thousands Separator is specified using this option, then the Thousands Separator is automatically set to ٬ (Unicode U+066C) by default.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
💡 Note: The Thousands Separator only applies to how the output number is displayed. It does not apply to the input number. The input number's Thousands Separator is taken from the system locale.
Examples:
{sepThousands : ""} : Default uses the system locale as the Thousands Separator.
{sepThousands : "."} : Uses dot (.) as the Thousands Separator.
// Examples
123.456.000
3.500.001{sepThousands : "'"} : Uses apostrophe (') as the Thousands Separator.
// Examples
123'456'000
3'500'001{sepThousands : " "} : Uses space as the Thousands Separator.
// Examples
123 456 000
3 500 001{sepThousands : "•"} : Uses dot symbol (•) as the Thousands Separator.
// Examples
123•456•000
3•500•001{sepThousands : "en"} : Uses the BCP 47 language tag 'en' as the Thousands Separator.
// Examples
123,456,000
3,500,001{sepThousands : "ar-sa"} : Uses the BCP 47 language tag ''ar-sa' (Arabic-Saudia) as the Thousands Separator.
// Examples
123٬456٬000
3٬500٬001{sepThousands : "fr"} : Uses the BCP 47 language tag 'fr' (French) as the Thousands Separator.
// Examples
123 456 000
3 500 001{sepThousands : "de"} : Uses the BCP 47 language tag 'de' (German) as the Thousands Separator.
// Examples
123.456.000
3.500.001⚠ Note 1: If the BCP 47 language tag is invalid, then the system locale setting is used.
⚠ Note 2: While it is possible to set both the Thousands Separator and the Decimal Separator to different BCP 47 language tags, it is recommended when using a BCP 47 language tag to use the same language tag for both the Thousands Separator and the Decimal Separator.
The brackets mode provides three (3 options):
{brackets : 'end'}(or{brackets : 'e'}){brackets : 'start'}(or{brackets : 's'}){brackets : 'deciaml'}(or{brackets : 'd'}) - See here for details on the Deciaml Parts in Brackets.
This provides a flexible method for enclosing the whole Number (in digital form) including its Decimal Part (if any) inside brackets, or only the Decimal Part at the end of the output text.
By default, no brackets are outputted.
The brackets may be at the end of the output text or at the start of the output text.
The default type of brackets is the round brackets "()". This may however be changed by the bracketsType option to other forms of brackets or other characters.
When the brackets option is enabled, the following options are also available to format the number inside the brackets:
bracketsTypechange the opening and closing bracket characters.numSymboladd the type of symbol or sign before or after the number.
If only the Decimal Part needs to be placed inside brackets rather than the Whole Number then use the option {brackets : 'deciaml'} (or {brackets : 'd'}) - See here for details on the Deciaml Parts in Brackets.
Examples:
//----------------------------------------
// Examples with the `brackets` at the start
//----------------------------------------
arqamAR.config({ brackets: "start"}); // add brackets at the start
arqamAR.toWords(256);
arqamAR.toWords(2500);
arqamAR.toWords(120000);
arqamAR.toWords(256,"USD");
arqamAR.toWords(2500,"USD");
arqamAR.toWords(120000,"USD");
// ===== Output =======
مائتان وستة وخمسون (256)
ألفان وخمسمائة (2,500)
مائة وعشرون ألفًا (120,000)
مائتان وستة وخمسون دولارًا أمريكيًا (256.00 USD)
ألفان وخمسمائة دولار أمريكي (2,500.00 USD)
مائة وعشرون ألف دولار أمريكي (120,000.00 USD)
//----------------------------------------
// Examples with the `brackets` at the end
//----------------------------------------
arqamAR.config({ brackets: "end"}); // add brackets at the end
arqamAR.toWords(256);
arqamAR.toWords(2500);
arqamAR.toWords(120000);
// ===== Output =======
(256) مائتان وستة وخمسون
(2,500) ألفان وخمسمائة
(120,000) مائة وعشرون ألفًا
(USD 256.00) مائتان وستة وخمسون دولارًا أمريكيًا
(USD 2,500.00) ألفان وخمسمائة دولار أمريكي
(USD 120,000.00) مائة وعشرون ألف دولار أمريكيChange the characters used with the brackets option, and therefore is only available when the brackets option is also enabled.
The default brackets type is the round brackets "()". This may be changed to (say) "[]" or "{}" or "<>" or any other characters.
The setting must contain 2 charaters (the opening type followed by closing type). For example: '[]', '{}', '<>', etc. An empty string sets the default '()' type. Any other characters may be used.
If only one charater is specified, it will be used for both the opening and closing characters.
Examples:
arqamAR.config({ brackets: "end", bracketsType : "[]" }); // change brackets to square brackets
arqamAR.toWords(256);
arqamAR.toWords(256,"USD");
// ===== Output =======
[256] مائتان وستة وخمسون // brackets changed to square brackets
[USD 256.00] مائتان وستة وخمسون دولارًا أمريكيًاThis option allows the symbol or sign to be specified, when using the brackets option in the Currency Mode and the Subjects Mode.
In the Currency Mode, the default sign/symbol is the 3-letter ISO Code.
arqamAR provides the Currency symbols (both in Native form and Latin form) for all currencies in accordance with the international standards. A full list of the Currency Symbols can be found here on Wikipedia: List of Currency Symbols.
Available pre-programmed settings in the Currency Mode are:
"iso"or""or"i": display the 3-letter ISO Code (this is the Default)."symbol"or"S"or"N", or"symbolN": display the Native symbol for the Currency."symbolL"or"L": display the Latin symbol for the Currency."currency"or"C": display the currency name.
However, you can specify any other string as the symbol/sign.
Applicability
- This option is only available when using the
bracketsoption. - This option is only available in the Currency Mode and the Subjects Mode.
Examples 1:
In the Currency Mode, using the Default (ISO Code).
//-----------------------------------------------
// Examples of the default sign/symbol (ISO Code)
//-----------------------------------------------
arqamAR.config({ brackets: "end" }); // add brackets at the end
arqamAR.toWords(256,"USD");
arqamAR.toWords(2500,"KWD");
arqamAR.toWords(120000,"QAR");
// ===== Output =======
(USD 256.00) مائتان وستة وخمسون دولارًا أمريكيًا
(KWD 2,500.00) ألفان وخمسمائة دينار كويتي
(QAR 120,000.00) مائة وعشرون ألف ريال قطري
Examples 2:
In the Currency Mode, using the Currency Native Symbol/Sign.
//----------------------------------------
// Examples of the Currency Native Symbol
//----------------------------------------
arqamAR.config({ brackets: "end" , numSymbol:"n" }); // native symbol
arqamAR.toWords(256,"USD");
arqamAR.toWords(2500,"KWD");
arqamAR.toWords(120000,"QAR");
// ===== Output =======
($ 256.00) مائتان وستة وخمسون دولارًا أمريكيًا
(2,500.000 د.ك.) ألفان وخمسمائة دينار كويتي
(120,000.00 ر.ق.) مائة وعشرون ألف ريال قطري
Examples 3:
In the Currency Mode, using the Currency Latin Symbol/Sign.
//-------------------------------------------
// Examples of the Currency Latin Symbol/Sign
//-------------------------------------------
arqamAR.config({ brackets: "end" , numSymbol:"L" }); // Latin symbol
arqamAR.toWords(256,"USD");
arqamAR.toWords(2500,"KWD");
arqamAR.toWords(120000,"QAR");
// ===== Output =======
($ 256.00) مائتان وستة وخمسون دولارًا أمريكيًا
(KD 2,500.000) ألفان وخمسمائة دينار كويتي
(QR 120,000.00) مائة وعشرون ألف ريال قطري
Examples 4:
In the Currency Mode, using the Currency Name.
//---------------------------------------------
// Examples of the Currency with Currency Name
//---------------------------------------------
arqamAR.config({ brackets: "end" , numSymbol:"C" }); // Currency Name
arqamAR.toWords(256,"USD");
arqamAR.toWords(2500,"KWD");
arqamAR.toWords(120000,"QAR");
// ===== Output =======
(256.00 دولار أمريكي) مائتان وستة وخمسون دولارًا أمريكيًا
(2,500.000 دينار كويتي) ألفان وخمسمائة دينار كويتي
(120,000.00 ريال قطري) مائة وعشرون ألف ريال قطري
Examples 5:
In the Currency Mode, using custom letters/signs.
//---------------------------------------------------
// Examples of the Currency with custom letters/signs
//---------------------------------------------------
arqamAR.toWords(25, {code:"OMR", brackets :"end", numSymbol:"ر؏"});
arqamAR.toWords(25, {code:"KWD", brackets :"end", numSymbol:"دڪ"});
// ===== Output =======
(25.000 ر؏) خمسة وعشرون ريالًا عُمانيًا
(25.000 دڪ) خمسة وعشرون دينارًا كويتيًا💡 See examples below on how this can be used in the Subjects Mode to add other symboles/signs/words like 'كم' or 'كغ', etc.
💡 When displaying Arabic text inside fields or html 'div's, set the text direction to Right-to-Left (RTL) for proper display especially when the text includes both Arabic and Latin characters.
💡 If you copy the output text to an MS Excel cell, set the cell format display to Right-to-Left (RTL) using 'Format Cells, Alignment, Text direction: Right-to-Left
The decRound option specifies the number of decimal places for upward rounding of the Decimal Part of the number.
Rounding only affects the Decimal Part of the number and will not affect or overflow to the Whole Part; this is intentional.
The default is "no rounding" and the entire digits of the Decimal Part of the number will be converted to text as they are.
Trailing zeros in a Decimal Part will not be converted to text. For example 0.12000 will be interpreted as 0.12 before conversion.
The default maximum number of decimal places is 10^1000 (جزء واحد من مائة دِيْوْتْرِيجِنْتاترِسِنْتِلْيون).
The maximum number of decimal places that can be converted by arqamAR is:
- 1 part of 100 نُوفِنوناجِنْتانونْجِنْتِلْيون which is (1 part of 10^3002) under the Short Scale System, and
- 1 part of 100 نُوفِنوناجِنْتانونْجِنْتِلْيَارات which is (1 part of 10^6000) under the Long Scale System.
Applicability
- This option is available in the Numbers Mode only.
- In the Currency Mode, the decimal part is automatically rounded to the currency sub-unit decimals (e.g. US Dollars to 2 decimal places, Kuwait Dinar to 3 decimal places).
Notes:
- The default in this option is no rounding in the Numbers Mode and to sub-unit decimal in Currency Mode.
- The number of rounding digits can be up to the
maxNumber.
Examples in Numbers Mode:
//--------------------------
// Examples using Numbers
//--------------------------
arqamAR.config({ decRound : 3 }); // round to 3 decimal places
arqamAR.toWords(22.1238);
arqamAR.toWords(22.3838);
arqamAR.toWords(22.9999);
// ===== Output =======
اثنان وعشرون، ومائة وأربعة وعشرون جزءًا من الألف
اثنان وعشرون، وثلاثمائة وأربعة وثمانون جزءًا من الألف
اثنان وعشرون، وتسعمائة وتسعة وتسعون جزءًا من الألف // note the whole number is not affected
//------------------------------------------------------------------
// Examples using Numbers in 'compact' mode for better understanding
//------------------------------------------------------------------
arqamAR.config({compact: "on" }); // round to 3 decimal places with compact mode
arqamAR.toWords(22.1238);
arqamAR.toWords(22.3838);
arqamAR.toWords(22.9999);
// ===== Output =======
22، و124 جزءًا من الـ1,000
22، و384 جزءًا من الـ1,000
22، و999 جزءًا من الـ1,000 // note the whole number is not affectedExample in Currency Mode:
//--------------------------
// Examples using Currencies
//--------------------------
arqamAR.config({ decRound : 3, compact: "on"}); // round to 3 decimal places with compact mode
arqamAR.toWords(22.1238, "USD");
arqamAR.toWords(22.3838, "USD");
arqamAR.toWords(22.9999, "USD");
// ===== Output =======
22 دولارًا أمريكيًا، و12 سنتًا
22 دولارًا أمريكيًا، و38 سنتًا
22 دولارًا أمريكيًا، و99 سنتًا // whole number not affected💡 The above is another example that shows how you can combine configuration options using the arqamAR.config() and using the arqamAR.toWords().
This option controls the text formatting of the Decimal Part of the number in both the Numbers Mode and the Currency Mode.
There are a total of nine (9) options of display and can be combined with other options.
The following table provides a summary of the decFormat settings in both the Numbers Mode and the Currency Mode with an example for the number 1.25 in numbers and USD currency.
| decFormat | Numbers Mode (example number 1.25) | Currency Mode (example number 1.25) |
|---|---|---|
| "" empty | واحد، وخمسة وعشرون جزءًا من المائة | دولار أمريكي واحد، وخمسة وعشرون سنتًا |
| ww | واحد، وخمسة وعشرون جزءًا من المائة | دولار أمريكي واحد، وخمسة وعشرون جزءًا من المائة دولار |
| wn | واحد، وخمسة وعشرون جزءًا من الـ100 | دولار أمريكي واحد، وخمسة وعشرون جزءًا من الـ100 دولار |
| nw | واحد، و25 جزءًا من المائة | دولار أمريكي واحد، و25 جزءًا من المائة دولار |
| nn | واحد، و25 جزءًا من الـ100 | دولار أمريكي واحد، و25 جزءًا من الـ100 دولار |
| sw | واحد، فاصلة اثنان، خمسة | دولار أمريكي واحد، وخمسة وعشرون سنتًا |
| n | واحد، فاصلة 25 | دولار أمريكي واحد، و25 سنتًا |
| d | واحد، و0.25 | دولار أمريكي واحد، و0.25 دولار |
| / | واحد، و25/100 | دولار أمريكي واحد، و25/100 دولار |
| w | واحد، فاصلة خمسة وعشرون | دولار أمريكي واحد، وخمسة وعشرون سنتًا |
Note 1: The word 'و' can be changed to the word 'فاصلة' using the option {decFaslah : 'on'}.
Note 2: The word 'الـ' can be removed using the option {decAL : "off"}.
Note 3: The word 'جزءًا من' can be removed using the option {decJuz : "off"}.
Note 4: Use the Right-to-Left (RTL) direction in your display code when displaying combined Arabic and English words.
Note 5: The settings 'sw', 'n', and 'w' settings in the Numbers Mode automatically enable the {decFaslah : 'on'} 'فاصلة' option.
Note 6: The 'sw' setting is not available in the Currency Mode. If used, it will default to the 'w' setting.
Note 7: The 'n' setting is the default setting with the compact option in the Currency Mode.
Note 8: The 'nn' setting is the default setting with the compact option in the Numbers Mode.
The following illustration summarises the decFormat settings with an example number:
Purpose
The option {brackets:"d"} permits the Decimal Part of the Number to be distinguished from the Whole Part. The Decimal Part could be the sub-unit of a currency.
Output
The Decimal Part of the Number (if any) will be enclosed in brackets (by default the round brackets) at the end of the output text.
If there is a Whole Number preceding the Decimal Part, a comma is inserted in between the two (2) parts.
The entire Decimal Part including the way it is formatted using the decFormat will be placed inside brackets.
The type of brackets characters can be changed using the bracketsOpen and bracketsClose options.
Applicability
- This option is available in both the Numbers Mode and the Currency Mode.
- This option only applies if there is a Decimal Part in the number.
- This option has no effect if the number is only decimal number (i.e. number below 1), unless the option addZero is also enabled.
Examples:
arqamAR.config( {brackets:"d"} );
// Example with Numbers only
arqamAR.toWords(113.13);
مائة وثلاثة عشر، (وثلاثة عشر جزءًا من المائة)
// Example with Currency
arqamAR.toWords(2000.2,"LBP");
ألفا ليرة لبنانية، و(عشرون قرشًا)
// Example A fraction only Number will not be placed in brackets except in addZero option
arqamAR.toWords(0.13);
ثلاثة عشر جزءًا من المائة
// Example A fraction only Number will not be placed in brackets except in addZero option
arqamAR.toWords(0.5,"OMR");
خمسمائة بيسة عمانية
// examples with only decimal numbers but using the "addZero" option
arqamAR.config( {brackets:"d", addZero :" on"} );
arqamAR.toWords(0.13);
صفر، (وثلاثة عشر جزءًا من المائة)
arqamAR.toWords(0.5,"OMR");
صفر ريال عماني، و(خمسمائة بيسة)In the formation of the Decimal Part of the number, the words 'جزءًا من' is used by default for certain Decimal Formats using the {decFormat} option.
With this option, the words 'جزءًا من' can be ignored (removed) by using the {decJuz: "off"} or {decJuz: ""}.
Examples in the default {decJuz: "on"}:
arqamAR.toWords(22.1);
arqamAR.toWords(22.2);
arqamAR.toWords(22.3);
arqamAR.toWords(22.238);
//======= Output ========
اثنان وعشرون، وجزء واحد من العشرة
اثنان وعشرون، وجزءان اثنان من العشرة
اثنان وعشرون، وثلاثة أجزاء من العشرة
اثنان وعشرون، ومائتان وثمانية وثلاثون جزءًا من الألفExamples with {decJuz: "off"}:
arqamAR.config( {decJuz:"off"} );
arqamAR.toWords(22.1);
arqamAR.toWords(22.2);
arqamAR.toWords(22.3);
arqamAR.toWords(22.238);
//======= Output ========
اثنان وعشرون، وواحد من العشرة
اثنان وعشرون، واثنان من العشرة
اثنان وعشرون، وثلاثة من العشرة
اثنان وعشرون، ومائتان وثمانية وثلاثون من الألفWhen displaying a Decimal Part with a Whole Part, mostly the joining word is the letter "و". For example:
واحد، وخمسة وعشرون جزءًا من المائة
This can be changed with the option {decFaslah : "on"}, and the output becomes:
واحد، فاصلة خمسة وعشرون جزءًا من المائة
In the Numbers Mode, this option is available with all decFormat settings.
In the Currency Mode, this option is available with all decFormat settings, except the 'w' setting.
See above the decFormat option for more details.
The Decimal Part of a number (and the Sub-Unit of a Currency Value) is not displayed in the output text and is completely ignore.
- This option is available in both the Numbers Mode and the Currency Mode.
Examples with the option {decIgnore: "on"}:
arqamAR.config( {decIgnore:"on"} );
arqamAR.toWords(22.01);
arqamAR.toWords(145.32);
arqamAR.toWords(22.01,"QAR");
arqamAR.toWords(145.32,"BHD");
// ========= Output ==========
// The Decimal Part is ignored
//============================
اثنان وعشرون
مائة وخمسة وأربعون
اثنان وعشرون ريالًا قطريًا
مائة وخمسة وأربعون دينارًا بحرينيًاThis option enables or disables the use of the word 'الـ' as used in the formatting of the Decimal Part with the {decFormat} option when using the 'ww', 'wn', 'nw', and 'nn' settings.
The default is with the {decAL: 'on'}
- This option is available in both the Numbers Mode and the Currency Mode.
- This option is only used with the Decimal Part.
Examples in the default {decAL: "on"}:
arqamAR.toWords(22.1);
arqamAR.toWords(22.2);
arqamAR.toWords(22.3);
arqamAR.toWords(22.238);
//======= Output ========
اثنان وعشرون، وجزء واحد من العشرة
اثنان وعشرون، وجزءان اثنان من العشرة
اثنان وعشرون، وثلاثة أجزاء من العشرة
اثنان وعشرون، ومائتان وثمانية وثلاثون جزءًا من الألفExamples with {decAL: "off"}:
arqamAR.config( {decAL:"off"} );
arqamAR.toWords(22.1);
arqamAR.toWords(22.2);
arqamAR.toWords(22.3);
arqamAR.toWords(22.238);
//======= Output ========
اثنان وعشرون، وجزء واحد من عشرة
اثنان وعشرون، وجزءان اثنان من عشرة
اثنان وعشرون، وثلاثة أجزاء من عشرة
اثنان وعشرون، ومائتان وثمانية وثلاثون جزءًا من ألفIn the Currency Mode, this option permits the output text to be displayed without the Country Name but keeps the Currency Name.
In the Subjects Mode, the the adjective/demonym is ignored.
- This option is only available in the Currency Mode and the Subjects Mode.
Examples in the option {ignoreCountry: "on"}:
arqamAR.config( {ignoreCountry:"on"} );
arqamAR.toWords(22.01,"QAR");
arqamAR.toWords(2000.01,"USD");
arqamAR.toWords(145.32,"BHD");
// ========= Output ==========
// The Country name is ignored
//============================
اثنان وعشرون ريالًا، ودرهم واحد
ألفا دولار، وسنت واحد
مائة وخمسة وأربعون دينارًا، واثنان وثلاثون فلسًا
This option is only available in the Currency Mode with brackets option.
The currency value by default is always displayed with the decimal part even if the decimal part is zero. For example:
(USD 2,000.00) ألفا دولار أمريكي
With this option set to 'off' ({currDecForce: "off"}), the Decimal Part is not displayed if zero. The output will become.
(USD 2,000) ألفا دولار أمريكي
- This option is only available in the Currency Mode.
- This option is only used with the brackets option.
Adds a prefix text to the outputted string.
Adds a suffix text to the outputted string.
The string to be returned if the number passed is not a valid number.
The default is an empty '' string.
This may be changed to any other string.
Examples
arqamAR.config( {isNaN:"ليس رقمًا"} );
arqamAR.toWords('');
arqamAR.toWords('text');
// ========= Output ==========
ليس رقمًا
ليس رقمًاThe batch process mode allows the processing of multiple numbers at the same time and can be used by passing an array of numbers in place of a single number.
The output will be an array containing the text for each number.
Example 1 with Numbers
arqamAR.toWords([22,777,1000,2000,3300,2500]);
// ========= Output ==========
[
'اثنان وعشرون',
'سبعمائة وسبعة وسبعون',
'ألف',
'ألفان',
'ثلاثة آلاف وثلاثمائة',
'ألفان وخمسمائة'
]Example 2 with Currency
arqamAR.toWords([22,777,1000,2000,3300,2500,0.55,1.6],"DZD");
// ========= Output ==========
[
'اثنان وعشرون دينارًا جزائريًا',
'سبعمائة وسبعة وسبعون دينارًا جزائريًا',
'ألف دينار جزائري',
'ألفا دينار جزائري',
'ثلاثة آلاف وثلاثمائة دينار جزائري',
'ألفان وخمسمائة دينار جزائري',
'ألفان وخمسمائة دينار جزائري وخمسة وخمسون سنتيمًا جزائريًا',
'دينار جزائري واحد، وستون سنتيمًا'
]You can modify an existing currency attributes and therefore adjusting or correcting such attributes as necessary.
Each Currency (or Subject) has 19 attributes; any of can be changed.
The following attributes are applicable in both the Currency Mode and the Subjects Mode.
currDecimal : The currency or subject minor sub-unit decimal places (normally 2 or 3).
Standard Currency Attributes:
majorSingle : Major currency or subject name (singular) e.g. 'دينار' 'ريال' 'دولار'
majorSingleC : Major currency country name or adjective/demonym (singuar). e.g. 'كويتي' 'أمريكي' 'قطري'
majorPlural : Major currency or subject name (plural) e.g. 'دنانير' 'ريالات' 'دولارات'
majorPluralC : Major currency country name or adjective/demonym (plural). e.g. 'كويتية' 'أمريكية' 'قطرية'
majorGender : Major currency or subject Gender; 0 for male gender and 1 for female gender.
minorSingle : Minor currency or subject name (singular) e.g. 'فلس' 'درهم' 'سنت'
minorSingleC : Minor currency country name or adjective/demonym (singuar). e.g. 'كويتي' 'أمريكي' 'قطري'
minorPlural : Minor currency or subject name (plural) e.g. 'فلوس' 'دراهم' 'سنتات'
minorPluralC : Minor currency country name or adjective/demonym (plural). e.g. 'كويتية' 'أمريكية' 'قطرية'
minorGender : Minor currency or subject Gender; 0 for male gender and 1 for female gender.
Tashkeel Currency Attributes: These are Optional
majorSingleT : Major currency name (singular) Tashkeel. e.g. 'دِينَار' 'رِيَال' 'دُولار'
majorSingleCT : Major currency country name (singuar) adjective/demonym Tashkeel. e.g. 'كُوَيتِيّ' 'أمْريكِيّ' 'قَطَرِيّ'
majorPluralT : Major currency name (plural) Tashkeel. e.g. 'دَنَانَيرٍ' 'رِيَالاتٍ' 'دُولاراتٍ'
majorPluralCT : Major currency country name (plural) adjective/demonym Tashkeel. e.g. 'كُوَيتِيَّةٍ' 'أمْريكِيَّةٍ' 'قَطَرِيَّةٍ'
minorSingleT : Major currency name (singular) Tashkeel. e.g. 'فِلْس' 'دِرْهَم' 'سِنْت'
minorSingleCT : Major currency country name (singuar) adjective/demonym Tashkeel. e.g. 'كُوَيتِيّ' 'أمْريكِيّ' 'قَطَرِيّ'
minorPluralT : Major currency name (plural) Tashkeel. e.g. 'فُلُوسٍ' 'دَرَاهمٍ' 'سِنْتَاتٍ'
minorPluralCT : Major currency country name (plural) adjective/demonym Tashkeel. e.g. 'كُوَيتِيَّةٍ' 'أمْريكِيَّةٍ' 'قَطَرِيَّةٍ'
⚠ Note 1: The singular forms for the minor and major (both currency (Subject) and country name (Adjective/demonym)) should not have any Tanween for the last character. This will be added by arqamAR depending on the word position. The other attribute entries must have Tanween Kasr for the last character.
⚠ Note 2: It is not essential to create the Tashkeel forms of the entries as the normal ones will be used by default.
Example 1 Changing the USD Currency Major Name
arqamAR.config( {
code : "USD",
majorSingle : "جنيه",
});
arqamAR.toWords(22.5);
arqamAR.toWords(100);
arqamAR.toWords(3);
// ========= Output ==========
اثنان وعشرون جنيهًا أمريكيًا، وخمسون سنتًا
مائة جنيه أمريكي
ثلاثة دولارات أمريكية⚠ Notice here that only the currency major singular name was changed and all other attributes remain unchanged. Normally if you want to change an attribute you need to change all its forms (i.e. in singular and plural including tashkeel forms)
A proper way to do that is as follows:
Example 2
arqamAR.config( {
code : "USD",
majorSingle : "جنيه",
majorPlural : "جنيهات",
});
arqamAR.toWords(22.5);
arqamAR.toWords(100);
arqamAR.toWords(3);
// ========= Output ==========
اثنان وعشرون جنيهًا أمريكيًا، وخمسون سنتًا
مائة جنيه أمريكي
ثلاثة جنيهات أمريكيةIf the existing 172 currencies provided by arqamAR are not enough and you want to create an all new currency you will need, as minimum, to provide three (3) settings:
- A new code to replace the ISO code. (this can be a 2 character word or any ISO code but in lower case).
- The currency name Singular (
majorSinglestring). - The currency name Plural (
majorPluralstring). - It is good to provide the name of the minor units (
minorSingleandminorPlural) to avoid arqamAR switching to thedecJuzmode and displaying the Decimal Parts as: 'جزء من'. - If you do not provide the
currDecimal, it will be assumed as 2 (i.e. there are 100 minor units in one major unit). - If you want to attach it to any particular country, then you can add the (
minorSingleCandminorPluralC) setting; otherwise no country name will be shown.
Example 1
Let us create a New Currency called 'سحتوت' that belongs to Egypt and has a sub-unit (minor) called 'مليم' with 3 decimal places.
arqamAR.config( {
code : "EGS", // a new non-ISO code (can be anything)
majorSingle : "سحتوت",
majorSingleC : "مصري",
majorPlural : "سحاتيت",
majorPluralC : "مصرية",
minorSingle : "مليم",
minorSingleC : "مصري",
minorPlural : "ملاليم",
minorPluralC : "مصرية",
currDecimal : 3, // 1000 مليم in 1 سحتوت
});
arqamAR.toWords(22.5);
arqamAR.toWords(100);
arqamAR.toWords(3);
// ========= Output ==========
اثنان وعشرون سحتوتًا مصريًا، وخمسمائة مليم
مائة سحتوت مصري
ثلاثة سحاتيت مصرية
⚠ Note 1: arqamAR enters the New Currency Mode if 3 attributes are provided (i.e. not empty): majorSingle, majorPlural, and code. To get out of the New Currency Mode, set the majorSingle and majorPlural to empty strings.
⚠ Note 2: The Tashkeel attributes are optional; if not stated, the standard names are used in the Tashkeel Option.
⚠ Note 3: To obtain the correct conversion into Arabic Text, it is important that you state the Gender of your new currency for both the Major Unit and the Minor Unit by using the {majorGender} and {minorGender} options. However, in the above example, we did not make any change because both the Major and Minor Units are male currency and sub-currency, which is the default. See the example below for a female currency.
Example 2
Let us now create a New Female Currency called 'نكلة' that belongs to "تركيا" and has a sub-unit (minor) called 'بقشة' with 2 decimal places. We also enable the Brackets Mode to show the number and code.
arqamAR.config( {
code : "NKL", // a new non-ISO code (can be anything)
majorSingle : "نكلة",
majorSingleC : "تركية",
majorPlural : "نكلات",
majorPluralC : "تركية",
majorGender : 1, // indicate Female Currency
minorSingle : "بقشة",
minorSingleC : "تركية",
minorPlural : "بقشات",
minorPluralC : "تركية",
minorGender : 1, // indicate Female sub-Currency
brackets :"end", // enable Brackets Mode
currDecimal : 2, // 100 بقشة in 1 نكلة
});
console.log( arqamAR.toWords(22.5) );
console.log( arqamAR.toWords(100) );
console.log( arqamAR.toWords(3) );
console.log( arqamAR.toWords(0.1) );
// ========= Output ==========
(22.50 NKL) اثنتان وعشرون نكلةً تركيةً، وخمسون بقشةً
(100.00 NKL) مائة نكلة تركية
(3.00 NKL) ثلاث نكلات تركية
(0.10 NKL) عشر بقشات تركية
⚠ Note 1: To obtain the correct conversion into Arabic Text, it is important that you state the Gender of your new currency for both the Major Unit and the Minor Unit.
Example 3
This example shows how you can create an all new currency using an existing currency data as a shortcut.
Let us create the old French currency 'Franc' (old ISO code FRF) and it had the sub-unit 'Centime'.
There are few countries that still use the Franc and Centime, one of them Guinea in west Africa.
Guinean Franc has the ISO code 'GNF' which we can use and modify.
But in the Brackets Mode, the code will be shown as 'GNF' not as 'FRF'. We can fix that with the option numSymbol
arqamAR.config( {
code : "GNF", //use Guinea ISO code
majorSingleC : "فرنسي", // change demonym (adjectives) for Single to France
majorPluralC : "فرنسية", // change demonym (adjectives) for Plural to France
minorSingleC : "فرنسي", // do the same for the sub-unit
minorPluralC : "فرنسية",
numSymbol : "FRF", // use France old ISO code
brackets :"end", // enale Brackets Mode to show the the code
});
console.log( arqamAR.toWords(22.5) );
console.log( arqamAR.toWords(100) );
console.log( arqamAR.toWords(3) );
console.log( arqamAR.toWords(0.1) );
// ========= Output ==========
(22.50 FRF) اثنان وعشرون فرنكًا فرنسيًا، وخمسون سنتيمًا
(100.00 FRF) مائة فرنك فرنسي
(3.00 FRF) ثلاثة فرنكات فرنسية
(0.10 FRF) عشرة سنتيمات فرنسية
Like creating a new currency, you can create other subjects to be counted. In this case you may not need to state the country name adjective (demonym).
To enter the Subjects Mode you need to set the code option to the word 'sub' {code : 'sub'}.
Let us create a subject kilometer 'كيلومتر' with the minor unit meter 'متر':
Example 1 Subject with a Sub-Subject
arqamAR.config( {
code : "sub", // use the 'Subjects Mode'
majorSingle : "كيلومتر",
majorPlural : "كيلومترات",
minorSingle : "متر",
minorPlural : "أمتار",
currDecimal : 3, //1000 meter in 1 kilometer
});
arqamAR.toWords(22.5);
arqamAR.toWords(100);
arqamAR.toWords(3);
arqamAR.toWords(0.25);
// ========= Output ==========
اثنان وعشرون كيلومترًا، وخمسمائة متر
مائة كيلومتر
ثلاثة كيلومترات
مائتان وخمسون مترًاLet us now create a subject that has no sub-subject like Degree 'درجة' :
Example 2 Subject without a Sub-Subject
arqamAR.config( {
code : "sub", // use the 'Subjects Mode'
majorSingle : "درجة",
majorPlural : "درجات",
});
arqamAR.toWords(22.5);
arqamAR.toWords(100);
arqamAR.toWords(3);
arqamAR.toWords(0.25);
// ========= Output ==========
اثنان وعشرون درجةً، وخمسون جزءًا من المائة درجة
مائة درجة
ثلاثة درجات
خمسة وعشرون جزءًا من المائة درجة⚠ Note above that because there is no minor unit provided, arqamAR automatically uses the words "جزءًا" for the Decimal Parts of the number.
Let us now create a subject that has no sub-subject but has an adjective (demonym) like Degree 'درجة مئوية' :
Example 3 Subject without a Sub-Subject by with an adjective
arqamAR.config( {
code : "sub", // use the 'Subjects Mode'
majorSingle : "درجة",
majorSingleC: "مئوية",
majorPlural : "درجات",
majorPluralC: "مئوية",
});
arqamAR.toWords(22.5);
arqamAR.toWords(100);
arqamAR.toWords(3);
arqamAR.toWords(0.25);
// ========= Output ==========
اثنان وعشرون درجةً مئويةً، وخمسون جزءًا من المائة درجة مئوية
مائة درجة مئوية
ثلاثة درجات مئوية
خمسة وعشرون جزءًا من المائة درجة⚠ Note here that unlike in the Currency Mode, the words "مئوية" is also repeated for the Decimal Part.
Let us now create a compounded subject like Kilometer per Hour 'كيلومتر في الساعة'.
We also add to it Meter per Hour 'متر في الساعة' as a sub-subject (or its minor unit).
Example 4 Compund Subject
arqamAR.config( {
code : "sub", // use the 'Subjects Mode'
majorSingle : "كيلومتر",
majorSingleC: "في الساعة",
majorPlural : "كيلومترات",
majorPluralC: "في الساعة",
minorSingle : "متر",
minorSingleC: "في الساعة",
minorPlural : "أمتار",
minorPluralC: "في الساعة",
currDecimal : 3, // 1000 meter in 1 kilometer
decSubInParts: "on" // see note below on this setting
});
arqamAR.toWords(1);
arqamAR.toWords(2);
arqamAR.toWords(1.5);
arqamAR.toWords(3);
arqamAR.toWords(100);
arqamAR.toWords(0.25);
// ========= Output ==========
كيلومتر واحد في الساعة
كيلومتران اثنان في الساعة
كيلومتر واحد في الساعة، وخمسمائة متر في الساعة
ثلاثة كيلومترات في الساعة
مائة كيلومتر في الساعة
مائتان وخمسون مترًا في الساعة⚠ Note 1: If the adjective (demonym) part of the subject is a compounded sentence such as 'per second' 'في الثانية' or per hour 'في الساعة', etc. then enable the option {decSubInParts : "on"} for a propr orienttion of the output text. However, arqamAR will automatically detect the presence of the words "في ال" in the {majorSingleC} and will use it in the {majorPluralC} setting, and will automatically set the {decSubInParts : "on"} option.
⚠ Note 2: Remember when using subjects like Square Kilometer 'كيلومتر مربع' or Square Meter 'متر مربع' that the decimal part should be correctly set.
1 Sqaure Kilometer = 1,000 x 1,000 = 1,000,000 Square Meter, so the deciaml should be set to 6 (not 3)!
Likewise, 1 Square Meter = 100 x 100 = 10,000 Square Centemeter, so the decimal should be set to 4 (not 2)!
Example 4 with Square Meter
arqamAR.config( {
code : "sub", // use the 'Subjects Mode'
majorSingle : "متر",
majorSingleC: "مربع",
majorPlural : "أمتار",
majorPluralC: "مربعة",
minorSingle : "سنتيمتر",
minorSingleC: "مربع",
minorPlural : "سنتيمترات",
minorPluralC: "مربعة",
currDecimal : 4, // note decimal is 4 not 2
});
arqamAR.toWords(1);
arqamAR.toWords(2);
arqamAR.toWords(1.5);
arqamAR.toWords(3);
arqamAR.toWords(100);
arqamAR.toWords(0.25);
// ========= Output ==========
متر مربع واحد
متران مربعان اثنان
متر مربع واحد، وخمسة آلاف سنتيمتر مربع // note 5000 cm2
ثلاثة أمتار مربعة
مائة متر مربع
ألفان وخمسمائة سنتيمتر مربع // note 2500 cm2Example 45 with Kilomgram using the Symbol and Brackets Mode
In this example we create the Subject 'Kilogram' and sub-Subject 'Gram' and also add the option to enable the Brackets Mode and add the symbol 'كغ'.
arqamAR.config( {
code : "sub", // use the 'Subjects Mode'
majorSingle : "كيلوغرام",
majorSingleC: "",
majorPlural : "كيلوغرامات",
majorPluralC: "",
minorSingle : "غرام",
minorSingleC: "",
minorPlural : "غرامات",
minorPluralC: "",
brackets :"end", // use the Brackets Mode
numSymbol :"كغ", // use the symbol "كغ" inside the brackets
currDecimal : 3, // 1000 gram in 1 kilogram
});
console.log(arqamAR.toWords(1));
console.log(arqamAR.toWords(2));
console.log(arqamAR.toWords(1.5));
console.log(arqamAR.toWords(3));
console.log(arqamAR.toWords(100));
console.log(arqamAR.toWords(0.25));
// ========= Output ==========كيلوغرام واحد (1 كغ)
كيلوغرامان اثنان(2 كغ)
كيلوغرام واحد ، وخمسمائة غرام (1.500 كغ)
ثلاثة كيلوغرامات (3 كغ)
مائة كيلوغرام (100 كغ)
مائتان وخمسون غرامًا (0.250 كغ)
1. Pass Large Numbers as a String
Very large numbers and very small decimal numbers should be passed to arqamAR as a string to avoid Javascript converting them to e-notation (exponent) numbers. arqamAR does not handle exponent numbers.
Consider the following:
console.log(arqamAR.towords(0.0000001));The output will be a blank String because arqam considers it not to be a number. What happended is that javascript passed the number to arqam as 1e-7.
arqamAR removed all non-digit character and the result was 1-7. This becomes a NaN.
You will get more understanding if you change the line to the following:
console.log(arqamAR.toWords(0.0000001, {isNaN:"ليس رقمًا"}));Now the output will be: ليس رقمًا
The above should be passed to arqamAR as a string as follows:
console.log(arqamAR.towords("0.0000001"));
//---- Correct Output ----
جزء واحد من العشرة ملايينSimilarly, for large numbers. See this funy example:
console.log(arqamAR.towords(1000000000000000000000));
//---- Incorrect Output ----
مائة وواحد وعشرونThe output is incorrect. The reason is that the number was passed by javascript to arqamAR as 1e21. arqamAR removed all non-digits and ended up with 121 and such number was converted.
Therefore, the above should be passed to arqamAR is a string as follows:
console.log(arqamAR.towords("1000000000000000000000"));
//---- Correct Output ----
سكستليونThe other reason that numbers be passed as strings is because javascript will tend to round approximate the number to fit its internal binary storage limits.
2. Currency List Array
arqamAR has a built-in table array of world currencies in a compact mode (simple encoding) to reduce the size of the arqamAR code.
The following tables provide guidance and assistance for differentiating between certain numbers under the three (3) cases of ʾIʿrāb Type (حالات الإعراب) with full tashkeel (تشكيلاً كاملاً).
22/11/2021 0.25 Added 'split' option to split the output text into parts in an array
Initial test web page created.
Added one more option to the Brackets Mode.
19/11/2021 0.24 Updated 'Compact' mode so that the numbers 1 and 2 are not compacted.
The words "إحدى عَشَرَة" corrected to "إحدى عَشْرَه" with skoon on the letter "ش".
Bug in ignoreCountry fixed. Country was not removed if currency has Decimal Part only.
11/11/2021 0.23 Add one more Tashkeel Option (now 6 options of Tashkeel).
Improved the Tanween Fatih function code.
10/11/2021 0.22 Improved output with no tashkeel at all.
Minor bug fixed in tanween fatih option.
08/11/2021 0.21 Currencies table now has currency symbols/signs in native and latin formats.
Renamed Library to 'arqamAR' for full version of Arabic numbers conversion.
Added more examples in the readme file.
Added more images with colour examples in readme file for better understanding.
Corrected "جزآن" to "جزءَان".
Corrected "جزئين" to "جزأين".
Added reference tables of numbers in words in readme file.
Add Test file (Currencies with Full Tashkeel All Ierab Types - No fractions).
07/11/2021 0.20 Symbols inside brackets can now be used in Subjects Modes; and can create things like "كغ", etc.
04/11/2021 0.19 Tanween-Fatih function now handles tashkeel modes.
03/11/2021 0.18 Double names conversion code improved to handle more subjects.
02/11/2021 0.17 Added code to Tashkeel single numbers differently to assist kids learn numbers.
Additional code was needed to handle the kids mode.
01/11/2021 0.16 Can now modify existing currencies.
29/10/2021 0.15 Option to create new currencies added.
Additional options added for creating new currencies.
27/10/2021 0.14 Subjects Mode added.
25/10/2021 0.13 Testing files started, bug fixes.
Verification of outputs in different Ierab modes against trusted sources.
19/10/2021 0.12 major code re-write, bug fixes.
17/10/2021 0.11 Ierab (Raf', Nasn, aand Jar) modes added.
Added changing the configuration through short cuts.
Made confguration options 'sticky'.
Decimal fractions can now be up to 3000 digits.
Custom 'toFixed' function created to replace javascript function.
Decimal rounding can be up to 3000 digits.
05/10/2021 0.10 Re-done the Tashkeel options now with 4 different options.
15/09/2021 0.09 Batch processing mode added.
Brackets can now be at start or d of the output text.
01/08/2021 0.08 Brackets Mode added.
Added option word Juz (جزء) for decimal numbers.
16/07/2021 0.07 Arabic-Eastern numbers option added.
15/07/2021 0.06 Decimal and Thousand separator options added.
Prefix and suffix option added.
12/07/2021 0.05 Currency data compacted to save code space.
Non-valid digits in inputs numbers are now ignored.
25/06/2021 0.04 All world currencies added.
21/06/2021 0.03 Compact mode added.
17/06/2021 0.02 added fractions conversion.
added format decimals options.
12/06/2021 0.01 initial test version.