1.1.2 • Published 3 years ago

universal-numbers-formatter v1.1.2

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

universal-numbers-formatter

Universal numbers formatter converts supplied number into different local format based on provided parameters. See below list of parameters.

Installation

NPM

npm install --save universal-numbers-formatter

Usage

import { universalNumbersFormatter } from 'universal-numbers-formatter';

const modifiedNumberObject1 = universalNumbersFormatter(
  13546595.12344,
  'en',
  'IN'
);
console.log('Test=1', modifiedNumberObject1);

// Result:
// {
//     longNotation: "1,35,46,595.12",
//     shortNotation: "1.35Cr"
// }

const modifiedNumberObject2 = universalNumbersFormatter(
  13546595.12344,
  'en',
  'US',
  true,
  'USD'
);
console.log('Test=2', modifiedNumberObject2);

// Result:
// {
//     longNotation: "$13,546,595.12",
//     shortNotation: "$13.55M"
// }

Using RequireJS:

define(['universal-numbers-formatter'], function (
  universalNumbersFormatter
) {});
// or
define(function (require) {
  var universalNumbersFormatter = require('universal-numbers-formatter');
});

In a node application:

const universalNumbersFormatter = require('universal-numbers-formatter');
universalNumbersFormatter.universalNumbersFormatter();
// or
const { universalNumbersFormatter } = require('universal-numbers-formatter');
universalNumbersFormatter();

Options

universalNumbersFormatter =
  (number, langaugeCode, countryCode, isCurrency, currencyCode);

Usage explanation

number : Number

(Mandatory) First argument must be number which is supposed to be converted.

langaugeCode : String

(Mandatory) Second argument must be string which denotes language code. Example en for English and de for German and so on. Show Details.

countryCode: String

(Mandatory) Third argument must be string which denotes country code. Example US for USA and IN for India and so on. Details. Show Details.

isCurrency: Boolean

(Optional) Fourth argument is optional. By default its value is false. If you need currency denotation then supply it as true and followed by currencyCode.

currencyCode: String

(Optional) Fifth argument is optional. If you need currency denotation, then first enable isCurrency as true and then supply currencyCode. For example - USD for Dollars and INR for Rupees and so on. The currency to use in currency formatting. Possible values are the ISO 4217 currency codes, such as "USD" for the US dollar, "EUR" for the euro, or "CNY" for the Chinese RMB. Show Details

Support

If my work made your life easier. You can support via

"Buy Me A Coffee"

Supported Language Codes

LanguagelanguageCode(ISO Code)
Abkhazianab
Afaraa
Afrikaansaf
Akanak
Albaniansq
Amharicam
Arabicar
Aragonesean
Armenianhy
Assameseas
Avaricav
Avestanae
Aymaraay
Azerbaijaniaz
Bambarabm
Bashkirba
Basqueeu
Belarusianbe
Bengali (Bangla)bn
Biharibh
Bislamabi
Bosnianbs
Bretonbr
Bulgarianbg
Burmesemy
Catalanca
Chamorroch
Chechence
Chichewa, Chewa, Nyanjany
Chinesezh
Chinese (Simplified)zh-Hans
Chinese (Traditional)zh-Hant
Chuvashcv
Cornishkw
Corsicanco
Creecr
Croatianhr
Czechcs
Danishda
Divehi, Dhivehi, Maldiviandv
Dutchnl
Dzongkhadz
Englishen
Esperantoeo
Estonianet
Eweee
Faroesefo
Fijianfj
Finnishfi
Frenchfr
Fula, Fulah, Pulaar, Pularff
Galiciangl
Gaelic (Scottish)gd
Gaelic (Manx)gv
Georgianka
Germande
Greekel
Greenlandickl
Guaranign
Gujaratigu
Haitian Creoleht
Hausaha
Hebrewhe
Hererohz
Hindihi
Hiri Motuho
Hungarianhu
Icelandicis
Idoio
Igboig
Indonesianid, in
Interlinguaia
Interlingueie
Inuktitutiu
Inupiakik
Irishga
Italianit
Japaneseja
Javanesejv
Kalaallisut, Greenlandickl
Kannadakn
Kanurikr
Kashmiriks
Kazakhkk
Khmerkm
Kikuyuki
Kinyarwanda (Rwanda)rw
Kirundirn
Kyrgyzky
Komikv
Kongokg
Koreanko
Kurdishku
Kwanyamakj
Laolo
Latinla
Latvian (Lettish)lv
Limburgish ( Limburger)li
Lingalaln
Lithuanianlt
Luga-Katangalu
Luganda, Gandalg
Luxembourgishlb
Manxgv
Macedonianmk
Malagasymg
Malayms
Malayalamml
Maltesemt
Maorimi
Marathimr
Marshallesemh
Moldavianmo
Mongolianmn
Nauruna
Navajonv
Ndongang
Northern Ndebelend
Nepaline
Norwegianno
Norwegian bokmålnb
Norwegian nynorsknn
Nuosuii
Occitanoc
Ojibweoj
Old Church Slavonic, Old Bulgariancu
Oriyaor
Oromo (Afaan Oromo)om
Ossetianos
Pālipi
Pashto, Pushtops
Persian (Farsi)fa
Polishpl
Portuguesept
Punjabi (Eastern)pa
Quechuaqu
Romanshrm
Romanianro
Russianru
Samise
Samoansm
Sangosg
Sanskritsa
Serbiansr
Serbo-Croatiansh
Sesothost
Setswanatn
Shonasn
Sichuan Yiii
Sindhisd
Sinhalesesi
Siswatiss
Slovaksk
Sloveniansl
Somaliso
Southern Ndebelenr
Spanishes
Sundanesesu
Swahili (Kiswahili)sw
Swatiss
Swedishsv
Tagalogtl
Tahitianty
Tajiktg
Tamilta
Tatartt
Telugute
Thaith
Tibetanbo
Tigrinyati
Tongato
Tsongats
Turkishtr
Turkmentk
Twitw
Uyghurug
Ukrainianuk
Urduur
Uzbekuz
Vendave
Vietnamesevi
Volapükvo
Wallonwa
Welshcy
Wolofwo
Western Frisianfy
Xhosaxh
Yiddishyi, ji
Yorubayo
Zhuang, Chuangza
Zuluzu

Supported Country Codes

CountrycountryCode(ISO Code)
AFGHANISTANAF
ALBANIAAL
ALGERIADZ
AMERICAN SAMOAAS
ANDORRAAD
ANGOLAAO
ANTARCTICAAQ
ANTIGUA AND BARBUDAAG
ARGENTINAAR
ARMENIAAM
ARUBAAW
AUSTRALIAAU
AUSTRIAAT
AZERBAIJANAZ
BAHAMASBS
BAHRAINBH
BANGLADESHBD
BARBADOSBB
BELARUSBY
BELGIUMBE
BELIZEBZ
BENINBJ
BERMUDABM
BHUTANBT
BOLIVIABO
BOSNIA AND HERZEGOVINABA
BOTSWANABW
BOUVET ISLANDBV
BRAZILBR
BRITISH INDIAN OCEAN TERRITORYIO
BRUNEI DARUSSALAMBN
BULGARIABG
BURKINA FASOBF
BURUNDIBI
CAMBODIAKH
CAMEROONCM
CANADACA
CAPE VERDECV
CAYMAN ISLANDSKY
CENTRAL AFRICAN REPUBLICCF
CHADTD
CHILECL
CHINACN
CHRISTMAS ISLANDCX
COCOS (KEELING) ISLANDSCC
COLOMBIACO
COMOROSKM
CONGOCG
CONGO, THE DEMOCRATIC REPUBLIC OF THECD
COOK ISLANDSCK
COSTA RICACR
CÔTE D'IVOIRECI
CROATIAHR
CUBACU
CYPRUSCY
CZECH REPUBLICCZ
DENMARKDK
DJIBOUTIDJ
DOMINICADM
DOMINICAN REPUBLICDO
ECUADOREC
EGYPTEG
EL SALVADORSV
EQUATORIAL GUINEAGQ
ERITREAER
ESTONIAEE
ETHIOPIAET
FALKLAND ISLANDS (MALVINAS)FK
FAROE ISLANDSFO
FIJIFJ
FINLANDFI
FRANCEFR
FRENCH GUIANAGF
FRENCH POLYNESIAPF
FRENCH SOUTHERN TERRITORIESTF
GABONGA
GAMBIAGM
GEORGIAGE
GERMANYDE
GHANAGH
GIBRALTARGI
GREECEGR
GREENLANDGL
GRENADAGD
GUADELOUPEGP
GUAMGU
GUATEMALAGT
GUINEAGN
GUINEA-BISSAUGW
GUYANAGY
HAITIHT
HEARD ISLAND AND MCDONALD ISLANDSHM
HONDURASHN
HONG KONGHK
HUNGARYHU
ICELANDIS
INDIAIN
INDONESIAID
IRAN, ISLAMIC REPUBLIC OFIR
IRAQIQ
IRELANDIE
ISRAELIL
ITALYIT
JAMAICAJM
JAPANJP
JORDANJO
KAZAKHSTANKZ
KENYAKE
KIRIBATIKI
KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OFKP
KOREA, REPUBLIC OFKR
KUWAITKW
KYRGYZSTANKG
LAO PEOPLE'S DEMOCRATIC REPUBLIC (LAOS)LA
LATVIALV
LEBANONLB
LESOTHOLS
LIBERIALR
LIBYA, STATE OFLY
LIECHTENSTEINLI
LITHUANIALT
LUXEMBOURGLU
MACAOMO
MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OFMK
MADAGASCARMG
MALAWIMW
MALAYSIAMY
MALDIVESMV
MALIML
MALTAMT
MARSHALL ISLANDSMH
MARTINIQUEMQ
MAURITANIAMR
MAURITIUSMU
MAYOTTEYT
MEXICOMX
MICRONESIA, FEDERATED STATES OFFM
MOLDOVA, REPUBLIC OFMD
MONACOMC
MONGOLIAMN
MONTENEGROME
MONTSERRATMS
MOROCCOMA
MOZAMBIQUEMZ
MYANMARMM
NAMIBIANA
NAURUNR
NEPAL, FEDERAL DEMOCRATIC REPUBLIC OFNP
NETHERLANDSNL
NETHERLANDS ANTILLESAN
NEW CALEDONIANC
NEW ZEALANDNZ
NICARAGUANI
NIGERNE
NIGERIANG
NIUENU
NORFOLK ISLANDNF
NORTHERN MARIANA ISLANDSMP
NORWAYNO
OMANOM
PAKISTANPK
PALAUPW
PALESTINE, STATE OFPS
PANAMAPA
PAPUA NEW GUINEAPG
PARAGUAYPY
PERUPE
PHILIPPINESPH
PITCAIRNPN
POLANDPL
PORTUGALPT
PUERTO RICOPR
QATARQA
RÉUNIONRE
ROMANIARO
RUSSIAN FEDERATIONRU
RWANDARW
SAINT HELENASH
SAINT KITTS AND NEVISKN
SAINT LUCIALC
SAINT PIERRE AND MIQUELONPM
SAINT VINCENT AND THE GRENADINESVC
SAMOAWS
SAN MARINOSM
SAO TOME AND PRINCIPEST
SAUDI ARABIASA
SENEGALSN
SERBIARS
SEYCHELLESSC
SIERRA LEONESL
SINGAPORESG
SLOVAKIASK
SLOVENIASI
SOLOMON ISLANDSSB
SOMALIASO
SOUTH AFRICAZA
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDSGS
SOUTH SUDANSS
SPAINES
SRI LANKALK
SUDANSD
SURINAMESR
SVALBARD AND JAN MAYENSJ
SWAZILANDSZ
SWEDENSE
SWITZERLANDCH
SYRIAN ARAB REPUBLICSY
TAIWANTW
TAJIKISTANTJ
TANZANIA, UNITED REPUBLIC OFTZ
THAILANDTH
TIMOR-LESTETL
TOGOTG
TOKELAUTK
TONGATO
TRINIDAD AND TOBAGOTT
TUNISIATN
TURKEYTR
TURKMENISTANTM
TURKS AND CAICOS ISLANDSTC
TUVALUTV
UGANDAUG
UKRAINEUA
UNITED ARAB EMIRATESAE
UNITED KINGDOMGB
UNITED STATESUS
UNITED STATES MINOR OUTLYING ISLANDSUM
URUGUAYUY
UZBEKISTANUZ
VANUATUVU
VENEZUELAVE
VIET NAMVN
VIRGIN ISLANDS, BRITISHVG
VIRGIN ISLANDS, U.S.VI
WALLIS AND FUTUNAWF
WESTERN SAHARAEH
YEMENYE
ZAMBIAZM
ZIMBABWEZW

Supported Currency Codes

Country (or Region)CurrencycurrencyCode
AFGHANISTANAfghaniAFN
ÅLAND ISLANDSEuroEUR
ALBANIALekALL
ALGERIAAlgerian DinarDZD
AMERICAN SAMOAUS DollarUSD
ANDORRAEuroEUR
ANGOLAKwanzaAOA
ANGUILLAEast Caribbean DollarXCD
ANTARCTICANo universal currencyNone
ANTIGUA AND BARBUDAEast Caribbean DollarXCD
ARGENTINAArgentine PesoARS
ARMENIAArmenian DramAMD
ARUBAAruban FlorinAWG
AUSTRALIAAustralian DollarAUD
AUSTRIAEuroEUR
AZERBAIJANAzerbaijanian ManatAZN
BAHAMASBahamian DollarBSD
BAHRAINBahraini DinarBHD
BANGLADESHTakaBDT
BARBADOSBarbados DollarBBD
BELARUSBelarussian RubleBYR
BELGIUMEuroEUR
BELIZEBelize DollarBZD
BENINCFA Franc BCEAOXOF
BERMUDABermudian DollarBMD
BHUTANNgultrumBTN
BHUTANIndian RupeeINR
BOLIVIA, PLURINATIONAL STATE OFBolivianoBOB
BOLIVIA, PLURINATIONAL STATE OFMvdolBOV
BONAIRE, SINT EUSTATIUS AND SABAUS DollarUSD
BOSNIA AND HERZEGOVINAConvertible MarkBAM
BOTSWANAPulaBWP
BOUVET ISLANDNorwegian KroneNOK
BRAZILBrazilian RealBRL
BRITISH INDIAN OCEAN TERRITORYUS DollarUSD
BRUNEI DARUSSALAMBrunei DollarBND
BULGARIABulgarian LevBGN
BURKINA FASOCFA Franc BCEAOXOF
BURUNDIBurundi FrancBIF
CAMBODIARielKHR
CAMEROONCFA Franc BEACXAF
CANADACanadian DollarCAD
CABO VERDECabo Verde EscudoCVE
CAYMAN ISLANDSCayman Islands DollarKYD
CENTRAL AFRICAN REPUBLICCFA Franc BEACXAF
CHADCFA Franc BEACXAF
CHILEUnidad de FomentoCLF
CHILEChilean PesoCLP
CHINAYuan RenminbiCNY
CHRISTMAS ISLANDAustralian DollarAUD
COCOS (KEELING) ISLANDSAustralian DollarAUD
COLOMBIAColombian PesoCOP
COLOMBIAUnidad de Valor RealCOU
COMOROSComoro FrancKMF
CONGOCFA Franc BEACXAF
CONGO, DEMOCRATIC REPUBLIC OF THECongolese FrancCDF
COOK ISLANDSNew Zealand DollarNZD
COSTA RICACosta Rican ColonCRC
CÔTE D'IVOIRECFA Franc BCEAOXOF
CROATIACroatian KunaHRK
CUBAPeso ConvertibleCUC
CUBACuban PesoCUP
CURAÇAONetherlands Antillean GuilderANG
CYPRUSEuroEUR
CZECH REPUBLICCzech KorunaCZK
DENMARKDanish KroneDKK
DJIBOUTIDjibouti FrancDJF
DOMINICAEast Caribbean DollarXCD
DOMINICAN REPUBLICDominican PesoDOP
ECUADORUS DollarUSD
EGYPTEgyptian PoundEGP
EL SALVADOR ElSalvador ColonSVC
EL SALVADORUS DollarUSD
EQUATORIAL GUINEACFA Franc BEACXAF
ERITREANakfaERN
ESTONIAEuroEUR
ETHIOPIAEthiopian BirrETB
EUROPEAN UNIONEuroEUR
FALKLAND ISLANDS (MALVINAS)Falkland Islands PoundFKP
FAROE ISLANDSDanish KroneDKK
FIJIFiji DollarFJD
FINLANDEuroEUR
FRANCEEuroEUR
FRENCH GUIANAEuroEUR
FRENCH POLYNESIACFP FrancXPF
FRENCH SOUTHERN TERRITORIESEuroEUR
GABONCFA Franc BEACXAF
GAMBIADalasiGMD
GEORGIALariGEL
GERMANYEuroEUR
GHANAGhana CediGHS
GIBRALTARGibraltar PoundGIP
GREECEEuroEUR
GREENLANDDanish KroneDKK
GRENADAEast Caribbean DollarXCD
GUADELOUPEEuroEUR
GUAMUS DollarUSD
GUATEMALAQuetzalGTQ
GUERNSEYPound SterlingGBP
GUINEAGuinea FrancGNF
GUINEA-BISSAUCFA Franc BCEAOXOF
GUYANAGuyana DollarGYD
HAITIGourdeHTG
HAITIUS DollarUSD
HEARD ISLAND AND McDONALD ISLANDSAustralian DollarAUD
HOLY SEE (VATICAN CITY STATE)EuroEUR
HONDURASLempiraHNL
HONG KONGHong Kong DollarHKD
HUNGARYForintHUF
ICELANDIceland KronaISK
INDIAIndian RupeeINR
INDONESIARupiahIDR
IRAN, ISLAMIC REPUBLIC OFIranian RialIRR
IRAQIraqi DinarIQD
IRELANDEuroEUR
ISLE OF MANPound SterlingGBP
ISRAEL NewIsraeli SheqelILS
ITALYEuroEUR
JAMAICAJamaican DollarJMD
JAPANYenJPY
JERSEYPound SterlingGBP
JORDANJordanian DinarJOD
KAZAKHSTANTengeKZT
KENYAKenyan ShillingKES
KIRIBATIAustralian DollarAUD
KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OFNorth Korean WonKPW
KOREA, REPUBLIC OFWonKRW
KUWAITKuwaiti DinarKWD
KYRGYZSTANSomKGS
LAO PEOPLE’S DEMOCRATIC REPUBLICKipLAK
LATVIAEuroEUR
LEBANONLebanese PoundLBP
LESOTHOLotiLSL
LESOTHORandZAR
LIBERIALiberian DollarLRD
LIBYALibyan DinarLYD
LIECHTENSTEINSwiss FrancCHF
LITHUANIAEuroEUR
LUXEMBOURGEuroEUR
MACAOPatacaMOP
MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OFDenarMKD
MADAGASCARMalagasy AriaryMGA
MALAWIKwachaMWK
MALAYSIAMalaysian RinggitMYR
MALDIVESRufiyaaMVR
MALICFA Franc BCEAOXOF
MALTAEuroEUR
MARSHALL ISLANDSUS DollarUSD
MARTINIQUEEuroEUR
MAURITANIAOuguiyaMRO
MAURITIUSMauritius RupeeMUR
MAYOTTEEuroEUR
MEMBER COUNTRIES OF THE AFRICAN DEVELOPMENT BANK GROUP ADBUnit of AccountXUA
MEXICOMexican PesoMXN
MEXICOMexican Unidad de Inversion (UDI)MXV
MICRONESIA, FEDERATED STATES OFUS DollarUSD
MOLDOVA, REPUBLIC OFMoldovan LeuMDL
MONACOEuroEUR
MONGOLIATugrikMNT
MONTENEGROEuroEUR
MONTSERRATEast Caribbean DollarXCD
MOROCCOMoroccan DirhamMAD
MOZAMBIQUEMozambique MeticalMZN
MYANMARKyatMMK
NAMIBIANamibia DollarNAD
NAMIBIARandZAR
NAURUAustralian DollarAUD
NEPALNepalese RupeeNPR
NETHERLANDSEuroEUR
NEW CALEDONIACFP FrancXPF
NEW ZEALANDNew Zealand DollarNZD
NICARAGUACordoba OroNIO
NIGERCFA Franc BCEAOXOF
NIGERIANairaNGN
NIUENew Zealand DollarNZD
NORFOLK ISLANDAustralian DollarAUD
NORTHERN MARIANA ISLANDSUS DollarUSD
NORWAYNorwegian KroneNOK
OMANRial OmaniOMR
PAKISTANPakistan RupeePKR
PALAUUS DollarUSD
PALESTINE, STATE OFNo universal currencyNone
PANAMABalboaPAB
PANAMAUS DollarUSD
PAPUA NEW GUINEAKinaPGK
PARAGUAYGuaraniPYG
PERUNuevo SolPEN
PHILIPPINESPhilippine PesoPHP
PITCAIRNNew Zealand DollarNZD
POLANDZlotyPLN
PORTUGALEuroEUR
PUERTO RICOUS DollarUSD
QATARQatari RialQAR
RÉUNIONEuroEUR
ROMANIANew Romanian LeuRON
RUSSIAN FEDERATIONRussian RubleRUB
RWANDARwanda FrancRWF
SAINT BARTHÉLEMYEuroEUR
SAINT HELENA, ASCENSION AND TRISTAN DA CUNHASaint Helena PoundSHP
SAINT KITTS AND NEVISEast Caribbean DollarXCD
SAINT LUCIAEast Caribbean DollarXCD
SAINT MARTIN (FRENCH PART)EuroEUR
SAINT PIERRE AND MIQUELONEuroEUR
SAINT VINCENT AND THE GRENADINESEast Caribbean DollarXCD
SAMOATalaWST
SAN MARINOEuroEUR
SAO TOME AND PRINCIPEDobraSTD
SAUDI ARABIASaudi RiyalSAR
SENEGALCFA Franc BCEAOXOF
SERBIASerbian DinarRSD
SEYCHELLESSeychelles RupeeSCR
SIERRA LEONELeoneSLL
SINGAPORESingapore DollarSGD
SINT MAARTEN (DUTCH PART)Netherlands Antillean GuilderANG
SISTEMA UNITARIO DE COMPENSACION REGIONAL DE PAGOS "SUCRE"SucreXSU
SLOVAKIAEuroEUR
SLOVENIAEuroEUR
SOLOMON ISLANDSSolomon Islands DollarSBD
SOMALIASomali ShillingSOS
SOUTH AFRICARandZAR
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDSNo universal currencyNone
SOUTH SUDANSouth Sudanese PoundSSP
SPAINEuroEUR
SRI LANKASri Lanka RupeeLKR
SUDANSudanese PoundSDG
SURINAMESurinam DollarSRD
SVALBARD AND JAN MAYENNorwegian KroneNOK
SWAZILANDLilangeniSZL
SWEDENSwedish KronaSEK
SWITZERLANDWIR EuroCHE
SWITZERLANDSwiss FrancCHF
SWITZERLANDWIR FrancCHW
SYRIAN ARAB REPUBLICSyrian PoundSYP
TAIWAN, PROVINCE OF CHINANew Taiwan DollarTWD
TAJIKISTANSomoniTJS
TANZANIA, UNITED REPUBLIC OFTanzanian ShillingTZS
THAILANDBahtTHB
TIMOR-LESTEUS DollarUSD
TOGOCFA Franc BCEAOXOF
TOKELAUNew Zealand DollarNZD
TONGAPa’angaTOP
TRINIDAD AND TOBAGOTrinidad and Tobago DollarTTD
TUNISIATunisian DinarTND
TURKEYTurkish LiraTRY
TURKMENISTANTurkmenistan New ManatTMT
TURKS AND CAICOS ISLANDSUS DollarUSD
TUVALUAustralian DollarAUD
UGANDAUganda ShillingUGX
UKRAINEHryvniaUAH

| UNITED ARAB EMIRATES