# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/ru/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale.mdx
---

title: resolveAliasLocale
description: Преобразует алиас локали в код локали, используемый пользовательским сопоставлением, без экземпляра GT. Справочник API для resolveAliasLocale.

---

[`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) — это автономная служебная функция из библиотеки Core от General Translation, которая преобразует канонический код локали обратно в код локали-алиаса, если настроено пользовательское сопоставление.

## Обзор [#overview]

Импортируйте `resolveAliasLocale` напрямую из `generaltranslation` и вызовите её, передав код локали и пользовательское сопоставление. Для этого не требуется API-ключ или экземпляр [GT](/docs/platform/core/reference/gt-class/constructor). Если нужен эквивалент на основе экземпляра, используйте метод [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) у экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { resolveAliasLocale } from 'generaltranslation';

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' },
};

console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
```

Сигнатура:

```typescript
resolveAliasLocale(locale: string, customMapping?: CustomMapping): string
```

## Как это работает [#how-it-works]

* **Обратный поиск.** Преобразует канонический код локали обратно в пользовательский алиас, заданный в [`customMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Резервный вариант.** Возвращает исходную локаль, если в сопоставлении нет подходящего алиаса.
* **Без состояния.** Не имеет побочных эффектов.

## Параметры [#parameters]

| Параметр                           | Описание                                                            | Тип                                                                   | Необязателен | По умолчанию |
| ---------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------ | ------------ |
| [`locale`](#locale)                | Канонический код локали, к которому должен разрешаться алиас.       | `string`                                                              | Нет          | —            |
| [`customMapping`](#custom-mapping) | Пользовательское сопоставление, используемое для разрешения алиаса. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Да           | —            |

### `locale` [#locale]

**Тип** `string` · **Обязательно**

Канонический код локали, к которому должен разрешаться алиас.

### `customMapping` [#custom-mapping]

**Тип** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Необязательно**

Пользовательское сопоставление, используемое для разрешения алиаса. Если сопоставление не задано, входная локаль возвращается без изменений.

## Возвращает [#returns]

**Тип** `string`

Код локали-алиаса, если для неё задано сопоставление; в противном случае — исходная локаль.

## Примеры [#examples]

```typescript
import { resolveAliasLocale } from 'generaltranslation';

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' },
};

// Преобразовать канонический в алиас
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// Локаль без mapping возвращает исходное значение
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```

## Примечания [#notes]

* Преобразует канонические коды локалей обратно в понятные пользователю алиасы.
* Возвращает исходную локаль, если сопоставление отсутствует.
* Необходимо для отображения названий локалей для пользователя.
* Работает с пользовательскими сопоставлениями локалей.
* Функция без состояния — без побочных эффектов.