# General Translation React SDKs (gt-react, gt-next): resolveCanonicalLocale
URL: https://generaltranslation.com/ru/docs/react/nextjs/reference/functions/resolve-canonical-locale.mdx
---

title: resolveCanonicalLocale
description: Преобразует настроенный алиас локали в канонический код локали BCP 47 в серверном коде Next.js App Router с General Translation. Справочник API для resolveCanonicalLocale.

---

Функция `resolveCanonicalLocale` преобразует локаль или настроенный алиас в её канонический код локали BCP 47. Импортируйте её из `gt-next/server` в серверном коде App Router.

`resolveCanonicalLocale` работает только на сервере и не поддерживается в Pages Router.

## Обзор [#overview]

```tsx
import { resolveCanonicalLocale } from 'gt-next/server';

const locale = resolveCanonicalLocale('brand-french'); // 'fr-FR'
```

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

| Параметр | Описание                                       | Тип      | Необязательный | По умолчанию |
| -------- | ---------------------------------------------- | -------- | -------------- | ------------ |
| `locale` | Код локали или алиас, который нужно разрешить. | `string` | Нет            | —            |

## Возвращаемое значение [#returns]

**Тип** `string`

Каноническая локаль, заданная для этого значения. Пользовательские алиасы берутся из [`customMapping`](/docs/react/reference/config#custom-mapping).

## Пример [#example]

```tsx
import { resolveCanonicalLocale } from 'gt-next/server';

resolveCanonicalLocale('en-us'); // 'en-US'
```