# generaltranslation: General Translation Core SDK: getLocaleEmoji
URL: https://generaltranslation.com/ru/docs/core/functions/locales/get-locale-emoji.mdx
---
title: getLocaleEmoji
description: Справка по API для отдельной функции getLocaleEmoji
---

## Обзор

Автономная функция `getLocaleEmoji` возвращает эмодзи флага или символ для кода локали без необходимости создавать экземпляр класса GT.
Она возвращает подходящие эмодзи флагов для стран и территорий на основе региона локали и поддерживает пользовательские сопоставления эмодзи.

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

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

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

***


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

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

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

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

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

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

`string` — эмодзи флага или символ, обозначающий локаль:

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

***

## Примеры

### Простое получение эмодзи

```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')); // "🇨🇭"
```

***


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

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

## Что дальше

* Используйте метод класса GT [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Получите свойства локали с помощью [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Получите названия локалей с помощью [`getLocaleName`](/docs/core/functions/locales/get-locale-name)
* Проверяйте локали с помощью [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)