# react-native: useLocaleProperties
URL: https://generaltranslation.com/ru/docs/react-native/api/helpers/use-locale-properties.mdx
---
title: useLocaleProperties
description: Справочник по API хук useLocaleProperties
---

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


## Обзор

Хук `useLocaleProperties` возвращает метаданные об указанной локали, включая её название, нативное название, язык, регион и сведения о системе письма.

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

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

### Параметры

| Параметр | Тип      | Описание                                                   |
| -------- | -------- | ---------------------------------------------------------- |
| `locale` | `string` | Код локали в формате BCP 47 (например, `'en-US'`, `'ja'`). |

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

Объект `LocaleProperties` со следующими полями:

| Поле                       | Тип      | Описание                                                              |
| -------------------------- | -------- | --------------------------------------------------------------------- |
| `code`                     | `string` | Код локали (например, `'en-US'`).                                     |
| `name`                     | `string` | Название локали на английском языке (например, `'American English'`). |
| `nativeName`               | `string` | Нативное название на собственном языке локали.                        |
| `languageCode`             | `string` | Подтег языка (например, `'en'`).                                      |
| `languageName`             | `string` | Название языка на английском языке.                                   |
| `nativeLanguageName`       | `string` | Название языка на его собственном языке.                              |
| `nameWithRegionCode`       | `string` | Название локали с указанием региона (например, `'English (US)'`).     |
| `nativeNameWithRegionCode` | `string` | Нативное название локали на собственном языке с указанием региона.    |
| `regionCode`               | `string` | Подтег региона (например, `'US'`).                                    |
| `regionName`               | `string` | Название региона на английском языке.                                 |
| `nativeRegionName`         | `string` | Название региона на собственном языке локали.                         |
| `scriptCode`               | `string` | Подтег системы письма (например, `'Latn'`).                           |
| `scriptName`               | `string` | Название системы письма на английском языке.                          |
| `nativeScriptName`         | `string` | Название системы письма на собственном языке локали.                  |
| `maximizedCode`            | `string` | Полностью развернутый код локали (например, `'en-Latn-US'`).          |

***

## Примеры

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

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

export default function LocaleInfo() {
  const locale = useLocale();
  const props = useLocaleProperties(locale); // [!code highlight]
  return (
    <div>
      <p>Name: {props.name}</p>
      <p>Native name: {props.nativeName}</p>
      <p>Region: {props.regionName}</p>
    </div>
  );
}
```

***


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

* Этот хук работает синхронно — он возвращает свойства напрямую.
* Полезен для создания пользовательских селекторов локали или отображения пользователям метаданных локали.

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

* Подробнее см. в разделе [коды локалей](/docs/core/locales).