# General Translation Platform: 理解区域设置代码
URL: https://generaltranslation.com/zh/docs/platform/core/guides/locale-codes.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 什么是区域设置代码？它们在 General Translation 技术栈中如何使用？

General Translation 使用区域设置代码来标识不同的语言、书写系统和地区，并在它们之间进行翻译。

## 什么是区域设置代码？ [#locale-codes]

区域设置是**一种语言或方言**。区域设置代码是指代区域设置的标准化表示方式。

例如，`en-US` 是一个区域设置代码，表示美国英语。

区域设置可以是笼统的，也可以是具体的：

* `zh` 是中文
* `zh-Hant` 是使用繁体字书写的中文
* `zh-Hant-HK` 是香港地区使用、以繁体字书写的中文

区域设置代码会告诉 General Translation 源文件是用什么语言编写的、要翻译成什么语言，以及如何格式化日期、数字和 Currency 等符合区域设置的值。

## 区域设置代码的工作原理 [#locale-codes-work]

General Translation 使用 **[BCP 47 Language Tag](https://www.techonthenet.com/js/language_tags.php)** 标准来定义区域设置代码。这个 Internet Best Current Practices (BCP) 语言标准规定了一种统一的方式，用于标识口语和书面语。

区域设置代码可以包含多个由 `-` 分隔的子标签：

* **语言代码** (必需) ：表示主要语言，例如英语的 `en` 或西班牙语的 `es`。语言代码遵循 **[ISO-639](https://wikipedia.org/wiki/List_of_ISO_639_language_codes)**。
* **文字系统代码** (可选) ：表示书写系统，例如表示拉丁字母的 `Latn`。文字系统代码遵循 **[ISO-15924](https://en.wikipedia.org/wiki/ISO_15924)**。
* **区域代码** (可选) ：指定国家或地区，例如美国的 `US` 或法国的 `FR`。区域代码遵循 **[ISO-3166](https://en.wikipedia.org/wiki/ISO_3166-2)**。

例如，`zh-Hant-HK` 可拆分为：

* `zh` 表示中文
* `Hant` 表示繁体中文
* `HK` 表示香港

合起来，`zh-Hant-HK` 的意思是“香港使用的繁体中文”。

### 等效的区域设置标签

有些区域设置标签在翻译上是等效的。

例如，`fr` 表示法语，等同于：

* `fr-FR`，表示法国使用的法语。
* `fr-Latn-FR`，表示法国使用并以拉丁字母书写的法语。

由于翻译结果相同，General Translation 库和平台通常不会区分这些等效代码。

Files API 会将请求区域设置解析为用于存储的受支持区域设置。批量[下载](/docs/platform/openapi/reference/files/download-many)和[文件信息](/docs/platform/openapi/reference/files/file-info)响应会保留每个请求中的区域设置代码，即使两个代码解析为同一已存储的翻译也是如此。

### 常见区域设置代码

| 区域设置代码       | 语言   | 书写系统 | 地区   | 描述       |
| ------------ | ---- | ---- | ---- | -------- |
| `en`         | 英语   | -    | -    | 英语       |
| `en-US`      | 英语   | -    | 美国   | 美国英语     |
| `en-GB`      | 英语   | -    | 英国   | 英国英语     |
| `es`         | 西班牙语 | -    | -    | 西班牙语     |
| `es-419`     | 西班牙语 | -    | 拉丁美洲 | 拉丁美洲西班牙语 |
| `fr`         | 法语   | -    | -    | 法语       |
| `fr-CA`      | 法语   | -    | 加拿大  | 加拿大法语    |
| `de`         | 德语   | -    | -    | 德语       |
| `de-AT`      | 德语   | -    | 奥地利  | 奥地利德语    |
| `ru`         | 俄语   | -    | -    | 俄语       |
| `zh-CN`      | 中文   | -    | 中国大陆 | 中国大陆中文   |
| `zh-Hant`    | 中文   | 繁体中文 | -    | 繁体中文     |
| `zh-Hant-SG` | 中文   | 繁体中文 | 新加坡  | 新加坡繁体中文  |
| `ja`         | 日语   | -    | -    | 日语       |
| `ko`         | 韩语   | -    | -    | 韩语       |
| `pt-BR`      | 葡萄牙语 | -    | 巴西   | 巴西葡萄牙语   |
| `it`         | 意大利语 | -    | -    | 意大利语     |

## General Translation 支持的区域设置 [#supported-locales]

`generaltranslation` 库支持任何格式有效的区域设置标签，包括没有广泛公认含义的私有使用代码。

不过，General Translation 平台只会翻译 GT 支持的区域设置。 (请前往 [支持的区域设置](/docs/platform/dashboard/reference/supported-locales) 页面查看最新的可搜索列表) 。

## Next steps

- /docs/platform/core/guides/translating-strings
- /docs/platform/core/guides/translating-files

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.