# gt-next: General Translation Next.js SDK: getLocale
URL: https://generaltranslation.com/ru/docs/next/api/helpers/get-locale.mdx
---
title: getLocale
description: Справка по API для серверного метода getLocale
---

## Обзор

Функция `getLocale` возвращает текущую локаль пользователя при серверном рендеринге.
Локаль возвращается в виде BCP 47 [кода локали](/docs/core/locales), например `'en-US'`.

<Callout>
  `getLocale` — это серверный метод, и его можно использовать только в серверных
  компонентах.
</Callout>

Для использования на клиенте см. [`useLocale`](/docs/next/api/helpers/use-locale).

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

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

Промис, который возвращает строку с текущей локалью пользователя, например `'en-US'`.

***

## Поведение при выборе резервной локали

Если запрашивается неподдерживаемая локаль, будет выбрана резервная локаль.

Например, если запрошена неподдерживаемая локаль,
и (1) пользователь указал в настройках браузера несколько предпочтительных локалей,
и (2) одна из этих локалей поддерживается вашим приложением,
тогда в качестве резервной будет выбрана локаль с наиболее подходящим языком.

Кроме того, если подходящих резервных локалей нет,
но две локали используют один и тот же язык (например, `en-US` и `en-GB`),
тогда в качестве резервной будет выбрана поддерживаемая локаль с тем же языком.

Если ни одно из этих условий не выполняется, будет использоваться локаль по умолчанию.

Сведения о настройке поддерживаемых локалей см. в документации [`gt.config.json`](/docs/next/api/config/gt-config-json).

***

## Примеры

### Базовое использование

Получите локаль пользователя при серверном рендеринге.

```javascript title="GetUserLocale.jsx" copy
import { getLocale } from 'gt-next/server';

export default async function GetUserLocale() {
  const locale = await getLocale(); // [!code highlight]
  return <p>User locale: {locale}</p>;
}
```

***


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

* Функция `getLocale` асинхронная, поэтому для получения локали нужно использовать `await`.
* Она предназначена именно для использования на сервере. Для клиентских компонентов см. [`useLocale`](/docs/next/api/helpers/use-locale).
* Возвращаемая локаль соответствует формату [кода локали](/docs/core/locales).

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

* Узнайте, как настроить список поддерживаемых локалей с помощью [withGTConfig()](/docs/next/api/config/with-gt-config).