persian-utilities

Persian Modules need to Improved Application. Collections of Persian Utils And Helpers Function.

Collections

• convertDigitsFaToEn
• convertDigitsEnToFa
• persianCardValidation
• timeAgo
• isNationalID
• numericalSeparator
• numericalWithoutSeparator
• wordifyNumbers
• abbNumber

Install

NPM

npm install persian-utilities

Usage

Import persian-utilities into your app's modules or import ES modules With Name

Apis

convertDigitsFaToEn

import { convertDigitsFaToEn } from 'persian-utilities';
convertDigitsFaToEn('۱۲۳۴'); // result : 1234

convertDigitsEnToFa

import { convertDigitsEnToFa } from 'persian-utilities';
convertDigitsEnToFa('1234'); // result : ۱۲۳۴

persianCardValidation

import { persianCardValidation } from 'persian-utilities';
persianCardValidation('6219861054512345'); // result : {bankName : "بانک سامان" , isValid : true}

timeAgo

second argument set Exact option

import { timeAgo } from 'persian-utilities';
// not exact mode
timeAgo('۱۴۰۱/۰۵/۰۹ ۱۰:۰۰'); // result : روز قبل 1
// exact mode
timeAgo('۱۴۰۱/۰۵/۰۹ ۱۰:۰۰', true); // result : ثانیه29 و ساعت2 و روز1

isNationalID

import { isNationalID } from 'persian-utilities';
isNationalID('1111111111'); // result : true

numericalSeparator

import { numericalSeparator } from 'persian-utilities';
numericalSeparator(entryNumber, separateLength?: number, separator?: string)

import { numericalSeparator } from 'persian-utilities';
// without Passing Any Option
numericalSeparator(100000); // result : 100,000
// with Customized options
numericalSeparator('10000', 2, '.'); // result : 1.00.00

numericalSeparator Arguments

index	argument	type	default value
1	entryNumber	string or number	-
2	separateLength (optional)	number	3
3	separator (optional)	string	","

numericalWithoutSeparator

import { numericalWithoutSeparator } from 'persian-utilities';
numericalWithoutSeparator(numberWithSeparator: string, separator?: string)

import { numericalWithoutSeparator } from 'persian-utilities';
// without Passing Any Option
numericalWithoutSeparator(100000); // result : 100,000
// with Customized options
numericalWithoutSeparator(1.00.00 , "."); // result : 10000

wordifynumbers

We Supported Entry Number Less Than 1 Trillion

import { wordifynumbers } from 'persian-utilities';
wordifynumbers(5620); // result : پنج هزار و ششصد و بیست
wordifyNumbers(153000); // result : یکصد و پنجاه و سه هزار
wordifyNumbers('۵۲۴۴۲۴۴۳۶۰۰'); // result : پنجاه و دو میلیارد و چهارصد و چهل و دو میلیون و چهارصد و چهل و سه هزار و ششصد

abbNumber

Convert long number into abbreviated string

import { abbNumber } from 'persian-utilities';
abbNumber(5620); // result : "5K"
abbNumber(1530000); // result : "1M"    
abbNumber(52100000,1); // result : "52.1M"

Large number abbreviations

number	abbr	name
>10^3	K	kilo
>10^6	M	mega
>10^9	G	giga
>10^12	T	tera
>10^15	P	peta
>10^18	E	exa