# General Translation React SDKs (gt-react, gt-next, gt-react-native): getLocale
URL: https://generaltranslation.com/ru/docs/react/nextjs/reference/functions/get-locale.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Получите локаль текущего запроса Next.js App Router с помощью General Translation. Справочник API для getLocale.

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

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

## Обзор [#overview]

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

const locale = await getLocale(); // 'en-US'
```

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

**Тип** `Promise<string>`

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

## Поведение при недопустимой локали [#invalid-locales]

Если локаль запроса не поддерживается, `gt-next` выводит предупреждение и возвращает `defaultLocale`. Установите [`disableInvalidLocaleWarning`](/docs/react/nextjs/config#disable-invalid-locale-warning), чтобы отключить предупреждение, не изменяя резервную локаль.

Для строгого маршрута `[locale]` проверьте параметр маршрута с помощью [`isLocaleSupported`](/docs/react/nextjs/reference/functions/is-locale-supported) и вызовите Next.js `notFound()` перед рендерингом. `getLocale` не возвращает 404 автоматически.

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

```tsx title="app/[locale]/layout.tsx"
import { getLocale } from 'gt-next/server';

export default async function LocaleLayout({ children }) {
  const locale = await getLocale();
  return <html lang={locale}>{children}</html>;
}
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
