# generaltranslation: General Translation Core SDK: getLocaleName
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/get-locale-name.mdx
---
title: getLocaleName
description: Documentazione di riferimento API per il metodo getLocaleName di GT
---

## Panoramica

Il metodo `getLocaleName` recupera il nome visualizzato di un codice locale tramite l'API `Intl.DisplayNames`.
Restituisce un nome comprensibile per qualsiasi codice locale BCP-47 valido, localizzato in base all'impostazione regionale di origine dell'istanza.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "French (Canada)"
```

***


## Riferimento

### Parametri

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

### Descrizione dei parametri

| Parametro | Descrizione                                                                                                                  |
| --------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | Codice locale BCP-47 di cui recuperare il nome visualizzato. Se non specificato, viene usato `targetLocale` dell&#39;istanza |

### Restituisce

`string` - Il nome visualizzato localizzato dell’impostazione regionale.

### Eccezioni

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

***

## Comportamento

### Lingua visualizzata

Il nome visualizzato è localizzato in base a:

1. `sourceLocale` dell&#39;istanza (se configurato)
2. Impostazione regionale predefinita della libreria (&#39;en&#39;)

### Integrazione della mappatura personalizzata

* Le mappature personalizzate delle impostazioni regionali vengono verificate per prime
* Se è definito un nome personalizzato, questo ha la precedenza
* In caso contrario, viene usato `Intl.DisplayNames` per i codici BCP-47 standard

***

## Esempi

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

// Ottieni il nome per l'impostazione regionale di destinazione
console.log(gt.getLocaleName()); // "French (France)"

// Ottieni i nomi per le altre impostazioni regionali
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"
```

***


## Note

* Il metodo usa `sourceLocale` dell&#39;istanza per determinare la lingua visualizzata
* I nomi di mappatura personalizzata hanno la precedenza su quelli standard di Intl.DisplayNames

## Passaggi successivi

* Ottieni l&#39;emoji dell&#39;impostazione regionale con [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Ottieni informazioni complete sull&#39;impostazione regionale con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* [Scopri di più sul tipo CustomMapping](/docs/core/types/custom-mapping)