# General Translation Platform: getLocaleEmoji
URL: https://generaltranslation.com/ru/docs/platform/core/reference/utility-functions/locales/get-locale-emoji.mdx
---

title: getLocaleEmoji
description: Возвращает эмодзи-маркер для локали или региона без экземпляра GT. Справочник API для getLocaleEmoji.

---

[`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) — это отдельная служебная функция из core library General Translation, которая возвращает флаг-эмодзи или символ для кода локали. Она выбирает флаг страны или территории на основе региона локали и поддерживает пользовательские сопоставления эмодзи.

## Обзор [#overview]

Импортируйте `getLocaleEmoji` напрямую из `generaltranslation` и вызовите её, передав код локали. Для этого не требуется API-ключ или экземпляр [GT](/docs/platform/core/reference/gt-class/constructor). Если нужен эквивалентный вариант для экземпляра, используйте метод [`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) у экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { getLocaleEmoji } from 'generaltranslation';

const emoji = getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (флаг Канады)

const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (флаг США)
```

Сигнатура:

```typescript
getLocaleEmoji(locale: string, customMapping?: CustomMapping): string
```

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

* **Выбор по региону.** Использует регион локали (если он указан) для выбора эмодзи флага с помощью Unicode Regional Indicator Symbols. Для некоторых языков используется эмодзи по умолчанию.
* **Приоритет `customMapping`.** Эмодзи, заданные в [`customMapping`](/docs/platform/core/reference/types/custom-mapping), имеют приоритет над выбором по региону.
* **Резервный вариант.** Возвращает эмодзи глобуса по умолчанию (`🌍`) для нераспознанных локалей.

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

| Параметр                           | Описание                                                               | Тип                                                                   | Необязательный | По умолчанию |
| ---------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------- | ------------ |
| [`locale`](#locale)                | Код локали BCP-47, для которой нужно получить эмодзи.                  | `string`                                                              | Нет            | —            |
| [`customMapping`](#custom-mapping) | Пользовательское сопоставление кодов локалей и переопределений эмодзи. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Да             | —            |

### `locale` [#locale]

**Тип** `string` · **Обязательно**

Код локали BCP-47, для которой нужно получить эмодзи.

### `customMapping` [#custom-mapping]

**Тип** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Необязательно**

Необязательная пользовательская настройка сопоставления для кодов локалей и переопределения эмодзи.

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

**Тип** `string`

Эмодзи-флаг или символ, обозначающий локаль:

* Эмодзи флага страны/территории для локалей с указанием региона (например, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Пользовательский эмодзи, если он задан в сопоставлении.
* Эмодзи глобуса по умолчанию (`🌍`) для нераспознанных локалей.

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

```typescript
import { getLocaleEmoji } from 'generaltranslation';

// Распространённые флаги стран
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"

// Регионы с несколькими языками
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"
```

## Примечания [#notes]

* Возвращает эмодзи-флаги, используя Unicode Regional Indicator Symbols.
* Эмодзи из Custom сопоставления имеют приоритет над выбором на основе региона.
* Поддерживаются все коды регионов ISO 3166-1 alpha-2 для максимально полного охвата.