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

## Обзор

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

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

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

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

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

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

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

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

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

***

## Примеры

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

```jsx title="LocaleInfo.jsx" copy
import { getLocaleProperties } from 'gt-next/server';

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

***


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

* Эта функция синхронная — `await` для неё не нужен.
* Полезна для создания селекторов локали или отображения метаданных локали пользователям.

## Что дальше

* См. [`useLocaleProperties`](/docs/next/api/helpers/use-locale-properties) — клиентский эквивалент.
* Подробнее о [кодах локалей](/docs/core/locales).