# generaltranslation: General Translation Core SDK: getLocaleEmoji
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/get-locale-emoji.mdx
---
title: getLocaleEmoji
description: Riferimento API del metodo getLocaleEmoji di GT
---

## Panoramica

Il metodo `getLocaleEmoji` restituisce una bandiera emoji o un simbolo per un codice locale in base alla relativa regione.
Restituisce le emoji di bandiera appropriate per paesi e territori, con fallback per le lingue senza regioni specifiche e supporto per emoji personalizzate tramite mappature.

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'fr-CA'
});

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

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

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

***


## Riferimento

### Parametri

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  }
}}
/>

### Descrizione dei parametri

| Parametro | Descrizione                                                                                                     |
| --------- | --------------------------------------------------------------------------------------------------------------- |
| `locale`  | Codice locale BCP-47 per cui ottenere l&#39;emoji. Se non viene fornito, usa il `targetLocale` dell&#39;istanza |

### Restituisce

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

* Emoji della bandiera del paese o territorio per le impostazioni regionali che includono una regione (ad esempio `🇺🇸`, `🇫🇷`, `🇯🇵`)
* Emoji specifica della lingua per alcune lingue senza regione
* Emoji di bandiera predefinita (`🏳️`) per impostazioni regionali non riconosciute

### Eccezioni

* `Error` - Se non viene fornita alcuna impostazione regionale e l&#39;istanza non ha `targetLocale` configurato

***

## Esempi

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

// Ottieni emoji per l'impostazione regionale di destinazione
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Ottieni emoji per diverse impostazioni regionali
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"
```

***


## Note

* Restituisce emoji di bandiera in base al codice della regione dell&#39;impostazione regionale, quando disponibile
* Le emoji definite tramite mappatura personalizzata hanno la priorità rispetto alla selezione basata sulla regione
* Usa i simboli indicatori regionali Unicode per generare le bandiere
* Per impostazione predefinita, usa `🏳️` (bandiera bianca) per le impostazioni regionali non riconosciute o non valide
* Compatibile con tutti i browser e i sistemi operativi moderni che supportano le emoji Unicode

## Passaggi successivi

* Ottieni le proprietà dell'impostazione regionale con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Ottieni i nomi delle impostazioni regionali con [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Convalida le impostazioni regionali con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* [Scopri di più sul tipo CustomMapping](/docs/core/types/custom-mapping)