Package Exports

i18n-iso-countries
i18n-iso-countries/codes.json
i18n-iso-countries/index
i18n-iso-countries/langs/ar.json
i18n-iso-countries/langs/cs.json
i18n-iso-countries/langs/da.json
i18n-iso-countries/langs/de.json
i18n-iso-countries/langs/en
i18n-iso-countries/langs/en.json
i18n-iso-countries/langs/es.json
i18n-iso-countries/langs/et.json
i18n-iso-countries/langs/fr.json
i18n-iso-countries/langs/hu.json
i18n-iso-countries/langs/it.json
i18n-iso-countries/langs/nb.json
i18n-iso-countries/langs/nl.json
i18n-iso-countries/langs/nn.json
i18n-iso-countries/langs/pl.json
i18n-iso-countries/langs/pt.json
i18n-iso-countries/langs/ru.json
i18n-iso-countries/langs/tr.json
i18n-iso-countries/langs/uk.json

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (i18n-iso-countries) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

i18n-iso-countries

i18n for ISO 3166-1 country codes. We support Alpha-2, Alpha-3 and Numeric codes from http://en.wikipedia.org/wiki/ISO_3166-1#Officially_assigned_code_elements

Code to Country

Get the name of a country by it's ISO 3166-1 Alpha-2, Alpha-3 or Numeric code

var countries = require("i18n-iso-countries");
console.log("US (Alpha-2) => " + countries.getName("US", "en")); // United States of America
console.log("US (Alpha-2) => " + countries.getName("US", "de")); // Vereinigte Staaten von Amerika
console.log("USA (Alpha-3) => " + countries.getName("USA", "en")); // United States of America
console.log("USA (Numeric) => " + countries.getName("840", "en")); // United States of America

Get all names by their ISO 3166-1 Alpha-2 code

var countries = require("i18n-iso-countries");
console.log(countries.getNames("en")); // { 'AF': 'Afghanistan', 'AL': 'Albania', [...], 'ZM': 'Zambia', 'ZW': 'Zimbabwe' }

Supported languages

ar: arabic
cs: czech
da: danish
de: german
en: english
es: spanish
et: estonian
fi: finnish
fr: french
hu: hungarian
it: italian
ko: korean
nb: Norwegian Bokmål
nl: dutch
nn: Norwegian Nynorsk
pl: polish
pt: portuguese
ru: russian
se: swedish
tr: turkish
uk: ukrainian
zh: Chinese

Country to Code

var countries = require("i18n-iso-countries");
console.log("United States of America => " + countries.getAlpha2Code('United States of America', 'en'));
// United States of America => US

console.log("United States of America => " + countries.getAlpha3Code('United States of America', 'en'));
// United States of America => USA

Codes

Convert Alpha-3 to Alpha-2 code

var countries = require("i18n-iso-countries");
console.log("USA (Alpha-3) => " + countries.alpha3ToAlpha2("USA") + " (Alpha-2)");
// USA (Alpha-3) => US (Alpha-2)

Convert Numeric to Alpha-2 code

var countries = require("i18n-iso-countries");
console.log("840 (Numeric) => " + countries.numericToAlpha2("840") + " (Alpha-2)");
// 840 (Numeric) => US (Alpha-2)

Convert Alpha-2 to Alpha-3 coe

var countries = require("i18n-iso-countries");
console.log("DE (Alpha-2) => " + countries.alpha2ToAlpha3("DE") + " (Alpha-3)");
// DE (Alpha-2) => DEU (Alpha-3)

Convert Numeric to Alpha-3 code

var countries = require("i18n-iso-countries");
console.log("840 (Numeric) => " + countries.numericToAlpha3("840") + " (Alpha-3)");
// 840 (Numeric) => USA (Alpha-3)

Convert Alpha-3 to Numeric code

var countries = require("i18n-iso-countries");
console.log(countries.alpha3ToNumeric("SWE"));
// 752

Convert Alpha-2 to Numeric code

var countries = require("i18n-iso-countries");
console.log(countries.alpha2ToNumeric("SE"));
// 752

Get all Alpha-2 codes

var countries = require("i18n-iso-countries");
console.log(countries.getAlpha2Codes());
// { 'AF': 'AFG', 'AX': 'ALA', [...], 'ZM': 'ZMB', 'ZW': 'ZWE' }

Get all Alpha-3 codes

var countries = require("i18n-iso-countries");
console.log(countries.getAlpha3Codes());
// { 'AFG': 'AF', 'ALA': 'AX', [...], 'ZMB': 'ZM', 'ZWE': 'ZW' }

Get all Numeric codes

var countries = require("i18n-iso-countries");
console.log(countries.getNumericCodes());
// { '004': 'AF', '008': 'AL', [...], '887': 'YE', '894': 'ZM' }

Contribution

To add a language:

add a json file under langs/
add the language to the data object in index.js at the top
add language to section Supported languages in README.md
add language to keywords in package.json
run npm install && make test to make sure that tests are passing
open a PR on GitHub