# generaltranslation: General Translation Core SDK: resolveCanonicalLocale
URL: https://generaltranslation.com/ru/docs/core/class/methods/locales/resolve-canonical-locale.mdx
---
title: resolveCanonicalLocale
description: Справка по API для метода GT resolveCanonicalLocale
---

## Обзор

Метод `resolveCanonicalLocale`, используемый в контексте локалей-алиасов (например, `cn` -> `zh`), преобразует коды локалей-алиасов в канонические коды локалей BCP-47, если настроено пользовательское сопоставление.

***

## Справочник

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

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Описание параметров

| Параметр        | Описание                                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `locale`        | Код локали-алиаса, который нужно привести к канонической форме. Если не указан, используется `targetLocale` экземпляра |
| `customMapping` | Необязательное пользовательское сопоставление, используемое вместо сопоставления экземпляра                            |

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

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

### Выбрасываемые исключения

* `Error` — если локаль не указана и для экземпляра не задан `targetLocale`

***

## Примеры

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: 'Mandarin' },
  }
});

// Преобразовать локаль-алиас в каноническую локаль
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Стандартные коды BCP-47 проходят без изменений
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"
```

***


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

* Преобразует коды локалей-алиасов в канонические коды локалей BCP-47
* Возвращает исходную локаль, если пользовательское сопоставление не задано
* Работает с параметром `customMapping` в конструкторе GT
* Входные и выходные коды локалей не валидируются

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

* Преобразуйте локали обратно в локали-алиасы с помощью [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Проверяйте корректность локалей с помощью [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Приводите формат локалей к стандартному виду с помощью [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale)