number-to-persian-text
Version:
convert number(s) to persian(farsi) text.
58 lines (45 loc) • 1.71 kB
Markdown
# Number to persian text
Change number (from number or string) to Persian (Farsi) text.
e.g. 1366 => هزار و سیصد و شصت و شش
## How to install
`npm i number-to-persian-text`
or
`yarn add number-to-persian-text`
## How to use
### usage 1:
```javascript
const persianNToText = require('number-to-persian-text');
persianNToText.getText('سال 2019 میلادی و 1398 شمسی'); // سال دو هزار و نوزده میلادی و یک هزار و سیصد ونود وهشت شمسی
persianNToText.getText('-23.34%'); //منفی بیست و سه ممیز سی و چهار صدم درصد
```
### usage 2:
see the example in \example\index.html
<html>
<head>
<script src="../dist/index.js"></script>
</head>
<body>
<div id="convertedText"></div>
<script type="text/javascript" charset="UTF-8">
document.getElementById('convertedText').innerHTML = NumberToPersianText.getText('1234');
</script>
</body>
### configuration
default config object :
```javascript
{
inputValidation: false,
moneyOutput: false,
moneyUnit: 'ريال'
}
```
inputValidation : to check input for valid number only
moneyOutput : weather the output should contain money unit
moneyUnit : custom money unit
### Change config object
to change config object call "changeConfig":
```javascript
const NumbertoPersianText = require('number-to-persian-text');
NumbertoPersianText.changeConfig({moneyOutput : true , moneyUnit: 'تومان'});
NumbertoPersianText.getText('1000000'); // یک میلیون تومان
```