Package Exports

i18n-iso-countries
i18n-iso-countries/codes.json
i18n-iso-countries/index
i18n-iso-countries/langs/ar.json
i18n-iso-countries/langs/bg.json
i18n-iso-countries/langs/cs.json
i18n-iso-countries/langs/da.json
i18n-iso-countries/langs/de.json
i18n-iso-countries/langs/el.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/hr.json
i18n-iso-countries/langs/hu.json
i18n-iso-countries/langs/it.json
i18n-iso-countries/langs/lt.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/ro.json
i18n-iso-countries/langs/ru.json
i18n-iso-countries/langs/sk.json
i18n-iso-countries/langs/sl.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

Installing

Install it using npm: npm install i18n-iso-countries

var countries = require("i18n-iso-countries");

// Support french & english languages.
countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
countries.registerLocale(require("i18n-iso-countries/langs/fr.json"));

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 (ISO 639-1)

ar: Arabic
az: Azerbaijani
be: Belorussian
bg: Bulgarian
bs: Bosnian
ca: Catalan
cs: Czech
da: Danish
de: German
en: English
es: Spanish
et: Estonian
fa: Persian
fi: Finnish
fr: French
el: Greek
he: Hebrew
hr: Croatian
hu: Hungarian
hy: Armenian
it: Italian
id: Indonesian
ja: Japanese
ka: Georgian
kk: Kazakh
ko: Korean
ky: Kyrgyz
lt: Lithuanian
lv: Latvian
mk: Macedonian
mn: Mongolian
nb: Norwegian Bokmål
nl: Dutch
nn: Norwegian Nynorsk
pl: Polish
pt: Portuguese
ro: Romanian
ru: Russian
sk: Slovak
sl: Slovene
sr: Serbian
sv: Swedish
tr: Turkish
uk: Ukrainian
uz: Uzbek
zh: Chinese

List of ISO 639-1 codes

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 code

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' }

Validate country code

var countries = require("i18n-iso-countries");
console.log(countries.isValid("US"), countries.isValid("USA"), countries.isValid("XX")));
// true, true, false

Contribution

To add a language:

add a json file under langs/
add the language to the data object in enty-node.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