@dior/i18n-iso-countries

中文文档
4.2.12发布于 2025/01/14MITTypeScriptCommonJS近 30 天下载 2137

iSO 3166-1 国家代码的i18n

中文使用文档
文档目录18 节
  1. 安装
  2. 代码到国家
  3. 以 ISO 3166-1- Alpha-2、 Alpha-3 或数字代码获取一个国家的名称
  4. 使用 ISO 3166-1 Alpha-2 代码获取所有名称
  5. 支助语言(ISO 639-1)
  6. 国家到代码
  7. 代码
  8. 将 Alpha-3 转换为 Alpha-2 代码
  9. 将数字转换为 Alpha-2 代码
  10. 将 Alpha-2 转换为 Alpha-3 代码
  11. 将数字转换为 Alpha-3 代码
  12. 将 Alpha-3 转换为数字代码
  13. 将 Alpha-2 转换为数字代码
  14. 获取所有 Alpha-2 代码
  15. 获取所有 Alpha-3 代码
  16. 获取全部数字代码
  17. 验证国家代码
  18. 捐款

Build Status NPM version

i18n-同位素国家

版本4放弃了对节点4和5的支持!

i18n用于ISO 3166-1国家代码. 我们支持Alpha-2,Alpha-3和数字代码来自 http://en.wikipedia.org/wiki/ISO 3166-1# 官方授权 编码 要素

安装

使用 npm 安装 : npm install i18n-iso-countries

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

如果您使用 i18n-iso-countries 和Node. j. 结束了。 如果您在浏览器环境中使用软件包,您还必须注册您想要使用的语言以最小化文件大小 .

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

代码到国家

以 ISO 3166-1- Alpha-2、 Alpha-3 或数字代码获取一个国家的名称

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 America

使用 ISO 3166-1 Alpha-2 代码获取所有名称

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

支助语言(ISO 639-1)

  • ar阿拉伯文
  • az: 阿塞拜疆语
  • be页: 1
  • bg: 保加利亚语
  • bs波斯尼亚语
  • ca: 加泰罗尼亚语
  • cs捷克语
  • da: 丹麦语
  • de: 德语
  • en页:1
  • es西班牙语
  • et: 爱沙尼亚语
  • fa: 波斯语
  • fi:芬兰语
  • fr法语
  • el: 希腊语
  • he希伯来语:
  • hr: 克罗地亚
  • hu: 匈牙利语
  • hy: 亚美尼亚语
  • it: 意大利语
  • id副主席: 印度尼西亚
  • ja: 日语
  • ka页:1
  • kk哈萨克语:
  • ko韩文:
  • ky吉尔吉斯斯坦语:
  • lt立陶宛语
  • lv: 拉脱维亚语
  • mk马其顿语
  • mn蒙古语:
  • nb挪威语: Bokmål
  • nl: 荷兰语
  • nn挪威尼诺尔斯克
  • pl波兰语
  • pt葡萄牙语
  • ro: 罗马尼亚
  • ru页:1
  • sk斯洛伐克语
  • sl: 斯洛文尼亚
  • sr塞尔维亚语
  • sv: 瑞典语
  • tr页:1
  • uk乌克兰语
  • ur: 乌尔都语
  • uz乌兹别克语
  • zh中文
  • vi: 越南语
  • tw台湾
  • hk: 洪刚

ISO 639-1 代码列表

国家到代码

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 => USA

代码

将 Alpha-3 转换为 Alpha-2 代码

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)

将数字转换为 Alpha-2 代码

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)

将 Alpha-2 转换为 Alpha-3 代码

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)

将数字转换为 Alpha-3 代码

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)

将 Alpha-3 转换为数字代码

var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.alpha3ToNumeric("SWE"));
// 752

将 Alpha-2 转换为数字代码

var countries = require("i18n-iso-countries");
// in a browser environment: countries.registerLocale(require("i18n-iso-countries/langs/en.json"));
console.log(countries.alpha2ToNumeric("SE"));
// 752

获取所有 Alpha-2 代码

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

获取所有 Alpha-3 代码

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

获取全部数字代码

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

验证国家代码

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, false

捐款

要添加语言:

  • 在 langs/ 下添加一个 json 文件
  • 将语言添加到 data 位于顶端的enty-node.js中的对象
  • 在区域中添加语言 支持的语言 在读取中
  • 在软件包中添加语言到关键字. json
  • 运行 npm install && make test 确保考试通过
  • 在 GitHub 上打开 PR

您可以在此检查代码 : https://www.iso.org/obp/ui/#home (英语)

版本与发布记录

@dior/i18n-iso-countries 共发布 11 个版本,首次发布于 2019/07/24;过去 12 个月发布了 0 个版本。

版本发布日期距今
4.2.12latest2025/01/141.8 年前
4.2.112024/11/132 年前
4.2.102024/09/242 年前
4.2.92024/04/102 年前
4.2.82024/04/102 年前
4.2.72023/11/222 年前

关于 @dior/i18n-iso-countries 的常见问题

@dior/i18n-iso-countries 是什么?

iSO 3166-1 国家代码的i18n

如何安装 @dior/i18n-iso-countries?

在项目目录运行 npm install @dior/i18n-iso-countries,或使用 pnpm add / yarn add / bun add。

@dior/i18n-iso-countries 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dior/i18n-iso-countries 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@dior/i18n-iso-countries 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 6。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dior/i18n-iso-countries 可以商用吗?

@dior/i18n-iso-countries 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dior/i18n-iso-countries 的下载量有多少?

根据 npm 官方下载统计,@dior/i18n-iso-countries 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,137 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dior/i18n-iso-countries 还在维护吗?

最新版本 4.2.12 发布于 2025/01/14(1.8 年前);至今共发布 11 个版本,其中过去 12 个月发布了 0 个;首次发布于 2019/07/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。