1.6.2 • Published 3 years ago
current-currency v1.6.2
current-currency 💵💶💷
Making it easy to work with currencies and cryptos!
Summary
Getting Started
Install current-currency with your favourite package manager.
npm install current-currency
yarn add current-currency
Available functions
convert
Convert is used to get the current rates of a currency.
Example
import { convert } from "current-currency";
convert("EUR", 10.2, "USD").then(res => console.log(res));
// {currency: "USD", amount: 12.35}
In the background we make use of https://exchangeratesapi.io/ to always have the current rates.
addSymbol
AddSymbol is used to add the right currency symbol in the right position using the ISO currency code.
Example
import { addSymbol } from "current-currency";
const symbolized = addSymbol("RUB", 10.2);
console.log(symbolized);
// ₽10.2
Example with force position
import { addSymbol } from "current-currency";
const symbolized = addSymbol("USD", 10.2, "post");
console.log(symbolized);
// 10.2$
extract
Extract is used to retrieve information about a currency using the ISO currency code.
Example
import { extract } from "current-currency";
const extraction = extract("10.2RUB");
console.log(extraction);
// { type: "currency", name: "Russian ruble", symbol: "₽", decimal: ",", position: "pre" }
Supported currencies
Code | Name |
---|---|
EUR | Euro |
USD | United States Dollar |
CAD | Canadian Dollar |
HKD | Hong Kong Dollar |
ISK | Icelandic Króna |
PHP | Philippine Peso |
DDK | Danish Krone |
HUF | Hungarian Forint |
CZK | Czech Koruna |
AUD | Australian Dollar |
RON | Romanian Leu |
SEK | Swedish Krona |
IDR | Indonesian Rupiah |
INR | Indian Rupee |
BRL | Brazilian Real |
RUB | Russian Ruble |
HRK | Croatian Kuna |
JPY | Japanse Yen |
TBH | Thai Baht |
CHF | Swiss Franc |
SGD | Singapore Dollar |
PLN | Polish złoty |
BGN | Bulgarian Lev |
TRY | Turkish Lira |
CNY | Chinese Renminbi |
NOK | Norwegian Krone |
NZD | New Zealand Dollar |
ZAR | South African Rand |
MXN | Mexican Peso |
ILS | Israeli Shekel |
GBP | Pound Sterling |
KRW | South Korean Won |
MYR | Malaysian Ringgit |
Supported cryptocurrencies
Code | Name |
---|---|
BTC | Bitcoin |
ETH | Ethereum |
LTC | Litecoin |
XRP | Ripple |
DOGE | Dogecoin |
1.6.2
3 years ago
1.6.0
3 years ago
1.4.4
3 years ago
1.5.0
3 years ago
1.4.3
3 years ago
1.4.2
3 years ago
1.4.1
3 years ago
1.4.0
3 years ago
1.3.3
3 years ago
1.3.2
3 years ago
1.3.1
3 years ago
1.2.1
3 years ago
1.2.0
3 years ago
1.1.2
3 years ago
1.1.1
3 years ago
1.1.0
3 years ago
1.0.4
3 years ago
1.0.3
3 years ago
1.0.1
3 years ago
1.0.0
3 years ago