# General Translation Platform: Что такое коды локалей
URL: https://generaltranslation.com/ru/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.