Iso 3166-1 alpha-3 codes download - final, sorry
npm
⚠️ 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 'Wikipedia: Officially assigned code elements'
Installing
Install it using npm:
var countries =require("i18n-iso-countries");
If you use with Node.js, you are done. If you use the package in a browser environment, you have to register the languages you want to use to minimize the 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",{select:"official"}));// United States of America
console.log("US (Alpha-2) => "+countries.getName("US","de",{select:"official"}));// Vereinigte Staaten von Amerika
console.log("USA (Alpha-3) => "+countries.getName("USA","en",{select:"official"}));// United States of America
console.log("USA (Numeric) => "+countries.getName("840","en",{select:"official"}));// United States of America
Get 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",{select:"official"}));// { 'AF': 'Afghanistan', 'AL': 'Albania', [...], 'ZM': 'Zambia', 'ZW': 'Zimbabwe' }
Supported languages (ISO 639-1)
In case you want to add new language, please refer ISO 639-1 table.
- : Arabic
- : Azerbaijani
- : Belorussian
- : Bulgarian
- : Bengali
- : Bosnian
- : Catalan
- : Czech
- : Danish
- : German
- : English
- : Spanish
- : Estonian
- : Persian
- : Finnish
- : French
- : Galician
- : Greek
- : Hebrew
- : Hindi
- : Croatian
- : Hungarian
- : Armenian
- : Italian
- : Indonesian
- : Japanese
- : Georgian
- : Kazakh
- : Korean
- : Kyrgyz
- : Lithuanian
- : Latvian
- : Macedonian
- : Mongolian
- : Malay
- : Norwegian Bokmål
- : Dutch
- : Norwegian Nynorsk
- : Polish
- : Portuguese
- : Romanian
- : Russian
- : Slovak
- : Slovene
- : Serbian
- : Swedish
- : Thai
- : Turkish
- : Ukrainian
- : Urdu
- : Uzbek
- : Chinese
- : Vietnamese
List of ISO 639-1 codes
Country to Code
var countries =require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
"United States of America => "+
countries.getAlpha2Code("United States of America","en")
// United States of America => US
"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");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
"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"));
"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"));
"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"));
Convert 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"));
Get 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"));
countries.isValid("US"),
countries.isValid("USA"),
countries.isValid("XX")
Contribution
To add a language:
- add a json file under langs/
- add the language to the object in entry-node.js at the top
- add language to section Supported languages in README.md
- add language to keywords in package.json
- run to make sure that tests are passing
- open a PR on GitHub
You can check codes here: https://www.iso.org/obp/ui/#home
-