# General Translation Platform: getLocaleName
URL: https://generaltranslation.com/ru/docs/platform/core/reference/gt-class-methods/locales/get-locale-name.mdx
---

title: getLocaleName
description: Возвращает понятное человеку имя локали. Справочник API для getLocaleName.

---

Возвращает отображаемое имя кода локали для экземпляра [GT](/docs/platform/core/reference/gt-class/constructor) с помощью API `Intl.DisplayNames`. General Translation возвращает понятное человеку имя для любого допустимого кода локали BCP-47, локализованное в соответствии с исходной локалью экземпляра.

## Обзор [#overview]

Вызовите `getLocaleName` у экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor), при необходимости передав код локали. Если код локали не указан, используется `targetLocale` экземпляра.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "Canadian French"
```

Сигнатура:

```typescript
getLocaleName(locale?: string): string
```

*Примечание: `getLocaleName` работает локально через `Intl.DisplayNames` и не требует ключа API. Если `locale` не указан, используется `targetLocale` экземпляра. Для поиска без экземпляра `GT` см. автономную [`getLocaleName`](/docs/platform/core/reference/utility-functions/locales/get-locale-name).*

## Как это работает [#how-it-works]

### Язык отображения

Отображаемое имя локализуется в зависимости от:

1. `sourceLocale` экземпляра (если настроено).
2. локали библиотеки по умолчанию (`'en'`).

### Интеграция пользовательских сопоставлений

* Сначала проверяются пользовательские сопоставления локалей.
* Если задано пользовательское название, оно имеет приоритет.
* В противном случае используется `Intl.DisplayNames` для стандартных кодов BCP-47.

### Локаль отсутствует

Выбрасывает `Error`, если локаль не указана и для экземпляра не настроен `targetLocale`. Возвращает пустую строку, если для корректной локали имя не найдено.

## Параметры [#parameters]

| Параметр            | Описание                                                        | Тип      | Необязательный | По умолчанию        |
| ------------------- | --------------------------------------------------------------- | -------- | -------------- | ------------------- |
| [`locale`](#locale) | Код локали BCP-47, для которой нужно получить отображаемое имя. | `string` | Да             | `this.targetLocale` |

### `locale` [#locale]

**Тип** `string` · **Необязательный** · **По умолчанию** `this.targetLocale`

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

## Возвращает [#returns]

**Тип** `string`

Локализованное отображаемое имя локали. Выбрасывает `Error`, если локаль не указана и у экземпляра не настроен `targetLocale`.

## Примеры [#examples]

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

// Получить название для целевой локали
console.log(gt.getLocaleName()); // "French"

// Получить названия для других локалей
console.log(gt.getLocaleName('es')); // "Spanish"
console.log(gt.getLocaleName('de')); // "German"
console.log(gt.getLocaleName('ja')); // "Japanese"
```

## Заметки [#notes]

* Метод использует `sourceLocale` экземпляра для определения языка отображения.
* Имена пользовательских сопоставлений имеют приоритет над стандартными `Intl.DisplayNames`.