# generaltranslation: General Translation Core SDK: resolveAliasLocale
URL: https://generaltranslation.com/ru/docs/core/functions/locales/resolve-alias-locale.mdx
---
title: resolveAliasLocale
description: Справка по API для функции resolveAliasLocale
---

## Обзор

Функция `resolveAliasLocale` преобразует коды канонической локали обратно в коды локали-алиаса, если настроено пользовательское сопоставление. Эта автономная функция делает то же, что и метод класса GT, но не требует создания экземпляра.

***

## Справка

### Параметры

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### Возвращает

`string` — код локали-алиаса, если сопоставление существует; в противном случае — исходная локаль

***

## Примеры

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

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

***


## Примечания

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

## Следующие шаги

* Используйте метод класса GT [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Приведите к каноническому виду с помощью [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)