---
description: Компонент, позволяющий переопределить локаль.
tags: provider
---

<Overview group="configuration">

# LocaleProvider [tag:component]

Компонент, позволяющий переопределить локаль.

</Overview>

## Локаль

Задаётся свойством `value`. В качестве значений принимает строку с [языковой меткой BCP 47](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry).

```jsx
<LocaleProvider value="en">
  {/* часть вашего приложения, требующая переопределения локали */}
</LocaleProvider>
```

## Хук useLocale [#use-locale]

Для получения значения текущей локали используйте хук `useLocale`:

```jsx
import { useLocale } from '@vkontakte/vkui';
```

```jsx
const locale = useLocale();
```

## Свойства и методы [#api]

### LocaleProvider

| Свойство | Тип | По умолчанию | Описание |
| --- | --- | --- | --- |
| `**children** \*` | `ReactNode` | `-` | Содержимое. |
| `**value** \*` | `string` | `-` | Строка с языковой меткой BCP 47. |

### useLocale

_Не принимает свойств_