currency-codes
A node.js module to list and work on currency codes based on the ISO 4217 standard.
npm install currency-codes
code('EUR')
var cc = require('currency-codes');
console.log(cc.code('EUR'));
/*
{
code: 'EUR',
number: 978,
digits: 2,
currency: 'Euro',
countries: [
'andorra', 'austria', 'belgium', 'cyprus', 'estonia', 'finland',
'france', 'germany', 'greece', 'ireland', 'italy', 'kosovo',
'luxembourg', 'malta', 'monaco', 'montenegro', 'netherlands',
'portugal', 'san marino', 'slovakia', 'slovenia', 'spain',
'vatican city' ]
}
*/number(967)
var cc = require('currency-codes');
console.log(cc.number(967));
/*
{
code: 'ZMW',
number: 967,
digits: 2,
currency: 'Zambian kwacha',
countries: [ 'zambia' ] }
*/country('colombia')
var cc = require('currency-codes');
console.log(cc.country('colombia'));
/*
[
{
code: 'COP',
number: 170,
digits: 2,
currency: 'Colombian peso',
countries: [ 'colombia' ]
}, {
code: 'COU',
number: 970,
digits: 2,
currency: 'Unidad de Valor Real',
countries: [ 'colombia' ]
}
]
*/codes()
var cc = require('currency-codes');
console.log(cc.codes());
/*
[
'AED',
'AFN',
...
'ZAR',
'ZMW'
]
*/numbers()
var cc = require('currency-codes');
console.log(cc.numbers());
/*
[
'784',
'971',
...
'710',
'967'
]
*/countries()
var cc = require('currency-codes');
console.log(cc.countries());
/*
[
'united arab emirates',
'afghanistan',
...
]
*/data
var data = require('currency-codes/data');
console.log(data);
/*
[{
code: 'AED',
number: '784',
digits: 2,
currency: 'United Arab Emirates dirham',
countries: ['united arab emirates']
}, {
code: 'AFN',
number: '971',
digits: 2,
currency: 'Afghan afghani',
countries: ['afghanistan']
}, {
...
*/publishDate
var cc = require('currency-codes');
console.log(cc.publishDate);
/*
2018-08-29
*/ISO-4217
Fetch the latest copy of ISO-4217 from the maintainer and update this library's currency data file.
$ npm run iso
> [email protected] iso currency-codes
> npm run iso:fetch-xml && npm run iso:ingest-xml
> [email protected] iso:fetch-xml currency-codes
> node scripts/fetch-iso-4217-xml.js
Downloaded https://www.currency-iso.org/dam/downloads/lists/list_one.xml to iso-4217-list-one.xml
> [email protected] iso:ingest-xml currency-codes
> node scripts/ingest-iso-4217-xml.js
Ingested iso-4217-list-one.xml into data.js
Wrote publish date to iso-4217-publish-date.jsNote: You may have to manually tweak the capitalization of some country's names.
License
MIT