# generaltranslation: General Translation Core SDK: getLocaleEmoji
URL: https://generaltranslation.com/it/docs/core/functions/locales/get-locale-emoji.mdx
---
title: getLocaleEmoji
description: Documentazione di riferimento API per la funzione getLocaleEmoji autonoma
---

## Panoramica

La funzione autonoma `getLocaleEmoji` restituisce una bandiera emoji o un simbolo per un codice locale senza richiedere un'istanza della classe GT.
Restituisce le emoji delle bandiere appropriate per paesi e territori in base alla regione del codice locale, con supporto per mappature emoji personalizzate.

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

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

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

***


## Riferimento

### Parametri

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

### Descrizione dei parametri

| Parametro       | Descrizione                                                                              |
| --------------- | ---------------------------------------------------------------------------------------- |
| `locale`        | Codice locale BCP-47 per cui ottenere l&#39;emoji                                        |
| `customMapping` | Mappatura personalizzata facoltativa per i codici locale e la sovrascrittura delle emoji |

### Valore restituito

`string` - Emoji di bandiera o simbolo che rappresenta l&#39;impostazione regionale:

* Emoji della bandiera del paese o territorio per le impostazioni regionali con regione (ad es. `🇺🇸`, `🇫🇷`, `🇯🇵`)
* Emoji personalizzata, se definita nella mappatura
* Emoji della bandiera predefinita (`🏳️`) per le impostazioni regionali non riconosciute

***

## Esempi

### Recupero di emoji di base

```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

* Restituisce emoji di bandiere usando i simboli Unicode degli indicatori regionali
* Le emoji con mappatura personalizzata hanno la priorità rispetto alla selezione basata sulla regione
* Supporta tutti i codici della regione ISO 3166-1 alpha-2 per una copertura completa

## Passaggi successivi

* Usa il metodo della classe GT [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Recupera le proprietà dell&#39;impostazione regionale con [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Recupera i nomi delle impostazioni regionali con [`getLocaleName`](/docs/core/functions/locales/get-locale-name)
* Convalida le impostazioni regionali con [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)