# generaltranslation: General Translation Core SDK: getLocaleEmoji
URL: https://generaltranslation.com/fr/docs/core/functions/locales/get-locale-emoji.mdx
---
title: getLocaleEmoji
description: Référence de l’API de la fonction autonome getLocaleEmoji
---

## Vue d’ensemble

La fonction autonome `getLocaleEmoji` renvoie un drapeau emoji ou un symbole pour un code de langue, sans nécessiter d’instance de la classe GT.
Elle renvoie les drapeaux emoji appropriés pour les pays et territoires selon la région du paramètre régional, avec prise en charge de mappages d’emojis personnalisés.

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

const emoji = getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (drapeau canadien)

const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (drapeau américain)
```

***


## Référence

### Paramètres

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

### Description des paramètres

| Paramètre       | Description                                                                           |
| --------------- | ------------------------------------------------------------------------------------- |
| `locale`        | Code de langue BCP-47 du paramètre régional dont il faut récupérer l’emoji            |
| `customMapping` | Mappage personnalisé facultatif pour les codes de langue et la redéfinition des emoji |

### Renvoie

`string` - Emoji de drapeau ou symbole représentant le paramètre régional :

* Emoji de drapeau de pays/territoire pour les paramètres régionaux avec région (par ex. `🇺🇸`, `🇫🇷`, `🇯🇵`)
* Emoji personnalisé s’il est défini dans le mappage
* Emoji de drapeau par défaut (`🏳️`) pour les paramètres régionaux non reconnus

***

## Exemples

### Récupération simple des émojis

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

// Drapeaux de pays courants
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')); // "🇨🇳"

// Régions avec plusieurs langues
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"
```

***


## Remarques

* Renvoie des émojis de drapeau à l’aide des symboles indicateurs régionaux Unicode
* Les émojis associés à un mappage personnalisé sont prioritaires sur la sélection basée sur la région
* Prend en charge tous les codes de région ISO 3166-1 alpha-2 pour une couverture exhaustive

## Étapes suivantes

* Utilisez la méthode [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji) de la classe GT
* Récupérez les propriétés du paramètre régional avec [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Récupérez les noms des paramètres régionaux avec [`getLocaleName`](/docs/core/functions/locales/get-locale-name)
* Validez les paramètres régionaux avec [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)