@brixtol/currency-symbols
v1.1.1
Published
Mappings from 3 letter currency codes to currency symbol
Downloads
1,200
Maintainers
Readme
@brixtol/currency-symbols
Currency (ISO 4217) 3 letter code mappings to Currency symbol. used by the Brixtol Textiles internal API when dealing with currency conversion and presentation locales.
Size
Minified: 1.52 KB Gzipped: 976 B
Install
pnpm i @brixtol/currency-symbols
npm install @brixtol/currency-symbols
yarn add @brixtol/currency-symbols
Usage
You can pass in a currency code that is lowercase, uppercase or a mixture of both.
import { getCurrencySymbol } from "@brixtol/currency-symbols";
// Currency code SEK (Krona)
const sek = getCurrencySymbol("SEK"); // Kr
// Currency code EUR (Euros)
const eur = getCurrencySymbol("eur"); // €
// Currency code USD (Dollar)
const usd = getCurrencySymbol("uSd"); // $
The module also exposes the raw mappings and interface on the export. The mappings object is provided read only using Object.freeze. The raw mappings are annotated with JSDoc comments so when using an editor that supports intellisense (ie: vscode) you will receive the country and currency name in completions and hovers.
import { CurrencySymbols, ICurrencySymbols } from "@brixtol/currency-symbols";
// Mapping Object
CurrencySymbols.SEK; // kr
CurrencySymbols.EUR; // €
CurrencySymbols.RUB; // ₽
CurrencySymbols.USD; // $
// Interface
ICurrencySymbols.SEK; // kr
ICurrencySymbols.EUR; // €
ICurrencySymbols.RUB; // ₽
ICurrencySymbols.USD; // $
The interface is identical to the mapping.
Crypto Mappings
The module supports 4 crypto currency mappings. Only cryptos that have alt-codes are supported, please submit a PR if any are missing.
- BTC (Bitcoin)
- ETH (Ethereum)
- LTL (Litecoin)
- XBT (Bitcoin)
Related
Country code to currency code mappings:
Country code to country name (English) mappings:
Currency Symbol placements (use with currency.js)
License
Licensed under MIT
We ♡ open source!