introduction
The module of node-i18n-iso-countries is awesome except that it does not support the traditional chinese. So, I forked the code from the original repo and made minor modification to support the traditional chinese.
i18n-iso-countries
Version 5 drops support for node 6 and 7!
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");If you use i18n-iso-countries with Node.js your are done. If you use the package in a browser environment you also have to register the languages you want to use to minimize file size.
// 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 its ISO 3166-1 Alpha-2, Alpha-3 or Numeric code
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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 AmericaGet all names by their ISO 3166-1 Alpha-2 code
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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 -
gl: Galician -
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 -
ms: Malay -
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 -
th: Thai -
tr: Turkish -
uk: Ukrainian -
ur: Urdu -
uz: Uzbek -
zh: Chinese (Simplified) -
tw: Chinese (Traditional) -
vi: Vietnamese
Country to Code
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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 => USACodes
Convert Alpha-3 to Alpha-2 code
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
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");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.alpha3ToNumeric("SWE"));
// 752Convert Alpha-2 to Numeric code
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.alpha2ToNumeric("SE"));
// 752Get all Alpha-2 codes
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getAlpha2Codes());
// { 'AF': 'AFG', 'AX': 'ALA', [...], 'ZM': 'ZMB', 'ZW': 'ZWE' }Get all Alpha-3 codes
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getAlpha3Codes());
// { 'AFG': 'AF', 'ALA': 'AX', [...], 'ZMB': 'ZM', 'ZWE': 'ZW' }Get all Numeric codes
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.getNumericCodes());
// { '004': 'AF', '008': 'AL', [...], '887': 'YE', '894': 'ZM' }Validate country code
var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.isValid("US"), countries.isValid("USA"), countries.isValid("XX"));
// true, true, falseContribution
To add a language:
- add a json file under langs/
- add the language to the
dataobject in entry-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 testto make sure that tests are passing - open a PR on GitHub
You can check codes here: https://www.iso.org/obp/ui/#home