# generaltranslation: General Translation Core SDK: getLocaleProperties
URL: https://generaltranslation.com/ru/docs/core/class/methods/locales/get-locale-properties.mdx
---
title: getLocaleProperties
description: Справочник по API метода GT getLocaleProperties
---

## Обзор

Метод `getLocaleProperties` возвращает полный набор свойств для кода локали, включая
подробную информацию: отображаемые названия, коды регионов, сведения о системе письма и эмодзи-флаги.
Он возвращает полный объект `LocaleProperties` со всеми данными, необходимыми для создания полноценных интернационализированных пользовательских интерфейсов.

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const props = gt.getLocaleProperties('fr-CA');
console.log(props.name); // "French (Canada)" — французский (Канада)
console.log(props.nativeName); // "français (Canada)"
console.log(props.emoji); // "🇨🇦"
```

***


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

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

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  }
}}
/>

### Описание параметров

| Параметр | Описание                                                                                                                |
| -------- | ----------------------------------------------------------------------------------------------------------------------- |
| `locale` | Код локали BCP-47, для которой нужно получить свойства. Если параметр не указан, используется `targetLocale` экземпляра |

### Возвращаемое значение

`LocaleProperties` — полный объект, содержащий всю информацию о локали:

* `code`: Стандартизированный код локали
* `name`: Отображаемое имя в исходной локали
* `nativeName`: Отображаемое имя в самой локали
* `languageCode`, `languageName`, `nativeLanguageName`: Информация о языке
* `regionCode`, `regionName`, `nativeRegionName`: Информация о регионе
* `scriptCode`, `scriptName`, `nativeScriptName`: Информация о системе письма
* `maximizedCode`, `minimizedCode`: Канонические формы
* `nameWithRegionCode`, `nativeNameWithRegionCode`: Комбинированные форматы отображения
* `emoji`: Флаг или соответствующий эмодзи

### Исключения

* `Error` — если локаль не указана и для экземпляра не настроен `targetLocale`

***

## Примеры

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

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'fr'
});

// Получить свойства для целевой локали
const props = gt.getLocaleProperties();
console.log(props.name); // "French (France)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Получить свойства для других локалей
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Austrian German"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Austria"
console.log(germanProps.nativeRegionName); // "Österreich"
```

***


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

* Все отображаемые названия учитывают настройку `sourceLocale` экземпляра
* Пользовательские свойства сопоставления имеют приоритет перед стандартными API Intl

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

* Изучите интерфейс [`LocaleProperties`](/docs/core/types/locale-properties)
* Узнайте, как получать простые названия локалей с помощью [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Узнайте, как получать эмодзи локали с помощью [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Узнайте о типе [`CustomMapping`](/docs/core/types/custom-mapping)