# react-native: useLocale
URL: https://generaltranslation.com/ru/docs/react-native/api/helpers/use-locale.mdx
---
title: useLocale
description: Справка по API для useLocale Hook
---

{/* СОЗДАНО АВТОМАТИЧЕСКИ: Не редактируйте напрямую. Вместо этого редактируйте template в content/docs-templates/. */}


## Обзор

Hook `useLocale` получает текущую локаль пользователя из [контекста `<GTProvider>`](/docs/react-native/api/components/gtprovider).
Локаль возвращается в формате кода локали BCP 47, например `'en-US'`. См. также [список кодов локалей](/docs/core/locales) и [документацию по `<GTProvider>`](/docs/react-native/api/components/gtprovider).

<Callout>
  `useLocale` — это Hook на стороне клиента, и *его можно использовать только в компонентах на стороне клиента*.
  Убедитесь, что ваше приложение обёрнуто в [`<GTProvider>`](/docs/react-native/api/components/gtprovider).
</Callout>

## Справка

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

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

***

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

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

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

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

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

См. документацию [`gt.config.json`](/docs/react-native/api/config/gt-config-json), чтобы узнать, как настроить поддерживаемые локали.

***

## Примеры

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

Получите текущую локаль и отобразите её в своём компоненте.

```jsx title="CurrentLocale.jsx" copy
'use client';
import { useLocale } from 'gt-react-native';

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

***


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

* Hook `useLocale` использует [`<GTProvider>`](/docs/react-native/api/components/gtprovider) для доступа к контексту. Убедитесь, что приложение обёрнуто в провайдер на корневом уровне.
* `useLocale` работает только на стороне клиента.
* Подробнее о кодах локалей — [здесь](/docs/core/locales).

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

* Узнайте, как управлять поддерживаемыми локалями в приложении и задавать их с помощью файла [`gt.config.json`](/docs/react-native/api/config/gt-config-json).