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

## Обзор

Метод `getLocaleName` получает отображаемое имя кода локали с помощью API `Intl.DisplayNames`.
Он возвращает понятное человеку название для любого допустимого кода локали BCP-47, локализованное в соответствии с исходной локалью экземпляра.

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

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

***


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

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

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

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

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

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

`string` — локализованное отображаемое имя локали.

### Выбрасывает

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

***

## Поведение

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

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

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

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

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

***

## Примеры

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

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

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

***


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

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

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

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