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

title: getLocaleEmoji
description: Restituisce un simbolo emoji per un'impostazione regionale o una regione senza un'istanza GT. Riferimento API per getLocaleEmoji.

---

[`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) è una funzione di utilità autonoma della libreria Core di General Translation che restituisce una bandiera emoji o un simbolo per un codice locale. Seleziona la bandiera di un paese o territorio in base alla regione dell'impostazione regionale, con supporto per mapping emoji personalizzati.

## Panoramica [#overview]

Importa `getLocaleEmoji` direttamente da `generaltranslation` e chiamalo con un codice locale. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente come metodo d'istanza, usa invece il metodo [`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

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

const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (bandiera degli Stati Uniti)
```

Firma:

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

## Come funziona [#how-it-works]

* **Selezione basata sulla regione.** Usa la regione dell'impostazione regionale (se presente) per selezionare un'emoji con la bandiera, utilizzando i simboli indicatori regionali Unicode. Per alcune lingue, usa emoji predefinite.
* **Priorità del mapping personalizzato.** Le emoji definite in un [`customMapping`](/docs/platform/core/reference/types/custom-mapping) hanno la priorità sulla selezione basata sulla regione.
* **Fallback.** Restituisce un'emoji del globo predefinita (`🌍`) per le impostazioni regionali non riconosciute.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                                 | Tipo                                                                  | Facoltativo | Predefinito |
| ---------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ----------- |
| [`locale`](#locale)                | Codice locale BCP-47 di cui ottenere l'emoji.                           | `string`                                                              | No          | —           |
| [`customMapping`](#custom-mapping) | Mapping personalizzato per i codici locale e le sovrascritture delle emoji. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —           |

### `locale` [#locale]

**Tipo** `string` · **Obbligatorio**

Il codice locale BCP-47 di cui ottenere l'emoji.

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

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facoltativo**

Una mapping personalizzato facoltativa per i codici locale e gli override delle emoji.

## Restituisce [#returns]

**Tipo** `string`

Un'emoji di bandiera o un simbolo che rappresenta l'impostazione regionale:

* Un'emoji con la bandiera di un paese/territorio per le impostazioni regionali che includono una regione (ad esempio `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Un'emoji personalizzata, se definita nella mappatura.
* L'emoji predefinita del globo (`🌍`) per le impostazioni regionali non riconosciute.

## Esempi [#examples]

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

// Bandiere nazionali comuni
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')); // "🇨🇳"

// Regioni con più lingue
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"
```

## Note [#notes]

* Restituisce emoji di bandiere usando i simboli indicatori regionali Unicode.
* Le emoji del mapping personalizzato hanno la precedenza sulla selezione basata sulla regione.
* Supporta tutti i codici regionali ISO 3166-1 alpha-2, per una copertura completa.