# General Translation React SDKs (gt-react, gt-next): useLocale
URL: https://generaltranslation.com/ru/docs/react/reference/hooks/use-locale.mdx
---

title: useLocale
description: Получайте активную локаль с помощью General Translation gt-react. Справочник API для useLocale.

---

Хук `useLocale` возвращает текущую локаль пользователя из context [`<GTProvider>`](/docs/react/reference/components/gt-provider) в виде кода локали BCP 47, например `en-US`.

*Доступно в `gt-react`, `gt-next`, `gt-tanstack-start` и `gt-react-native`. В примерах используется импорт из `gt-react`; вместо этого импортируйте из пакета вашего фреймворка.*

## Обзор [#overview]

Вызовите `useLocale`, чтобы получить активную локаль.

```tsx
import { useLocale } from 'gt-react';

export default function CurrentLocale() {
  const locale = useLocale(); // [!code highlight]
  return <p>Current locale: {locale}</p>;
}
```

*Примечание: в `gt-react` вызывайте `useLocale` внутри [`<GTProvider>`](/docs/react/reference/components/gt-provider). В `gt-next` это также работает в синхронных серверных компонентах.*

## Как это работает [#how-it-works]

Когда запрашивается неподдерживаемая локаль, выбирается резервная локаль:

* Если у пользователя в браузере настроено несколько предпочтительных локалей и одна из них поддерживается, используется наиболее подходящая из поддерживаемых локалей.
* В противном случае, если две локали соответствуют одному и тому же языку (например, `en-US` и `en-GB`), используется поддерживаемая локаль для этого языка.
* Если ни одно из этих условий не выполняется, используется [локаль по умолчанию](/docs/react/reference/config#default-locale).

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

**Тип** `string`

Текущая локаль пользователя, например `en-US`.

## Заметки [#notes]

* В асинхронном компоненте App Router вместо этого используйте [`getLocale`](/docs/react/nextjs/reference/functions/get-locale).
* Чтобы изменить локаль, используйте [`useSetLocale`](/docs/react/reference/hooks/use-set-locale); чтобы получить локаль источника, используйте [`useDefaultLocale`](/docs/react/reference/hooks/use-default-locale).