# generaltranslation: General Translation Core SDK: Локали
URL: https://generaltranslation.com/ru/docs/core/locales.mdx
---
title: Локали
description: Что такое локали и как они используются в экосистеме General Translation?
---

Локаль — это **язык или диалект**.
Например, `en-US` — это код локали, обозначающий английский язык, на котором говорят в Соединённых Штатах Америки.

Локали могут быть общими или более конкретными. Например:

* `en` — это английский
* `en-US` — это английский, на котором говорят в Соединённых Штатах Америки
* `zh` — это китайский
* `zh-Hant` — это китайский, записанный традиционными иероглифами
* `zh-Hant-HK` — это китайский, записанный традиционными иероглифами, на котором говорят в Гонконге

### Формирование кодов локалей

General Translation использует стандарт [языкового тега BCP 47](https://www.techonthenet.com/js/language_tags.php) для определения кодов локалей.
Языковые теги BCP 47 — это интернет-стандарт Best Current Practice (BCP) для обозначения языков как в устной, так и в письменной форме.
Эти теги задают единый способ указания языков, позволяя GT адаптировать контент, форматирование и поведение в зависимости от локали пользователя.

Коды локалей состоят из одного или нескольких подтегов, разделённых символом `-`. Эти подтеги:

* **Код языка** (обязателен): Обозначает основной язык, например `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` означает «китайский язык в традиционной письменности, используемый в Гонконге».

### Список поддерживаемых локалей [#supported-locales]

См. [список поддерживаемых локалей](/docs/platform/supported-locales), где приведён список с возможностью поиска по всем локалям, которые сейчас поддерживает General Translation.

Технически библиотека поддерживает любой корректно сформированный тег, включая коды частного использования без общепринятого значения.
Однако платформа будет переводить только

### Эквивалентные теги локалей

Иногда несколько тегов локалей функционально эквивалентны.
Например, можно написать:

* `fr`, то есть «французский»
* `fr-FR`, то есть «французский, используемый во Франции»
* `fr-FR-Latn`, то есть «французский, используемый во Франции и записываемый латиницей»

Библиотеки и платформа General Translation обычно не различают эти эквивалентные коды,
поскольку перевод между ними невозможен.

### Часто используемые коды локалей

| Код локали   | Язык          | Письменность                  | Регион                  | Описание                              |
| ------------ | ------------- | ----------------------------- | ----------------------- | ------------------------------------- |
| `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`         | Итальянский   | ―                             | ―                       | Итальянский                           |

### Что дальше

* См. наш [список поддерживаемых локалей](/docs/platform/supported-locales), чтобы узнать, какие языковые теги доступны в General Translation.
* Дополнительные сведения см. в официальном [реестре языковых тегов IETF](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry)
  и в стандарте [языковых тегов BCP 47](https://www.techonthenet.com/js/language_tags.php).