# General Translation Platform: getLocaleName
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/locales/get-locale-name.mdx
---

title: getLocaleName
description: Restituisce un nome leggibile per un'impostazione regionale. Riferimento API per getLocaleName.

---

Recupera il nome visualizzato di un codice locale in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor) utilizzando l'API `Intl.DisplayNames`. General Translation restituisce un nome leggibile per qualsiasi codice locale BCP-47 valido, localizzato in base all'impostazione regionale sorgente dell'istanza.

## Panoramica [#overview]

Chiama `getLocaleName` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale opzionale. Se non viene specificato, viene usato `targetLocale` dell'istanza.

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

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

Firma:

```typescript
getLocaleName(locale?: string): string
```

*Nota: `getLocaleName` viene eseguito localmente tramite `Intl.DisplayNames` e non richiede una chiave API. Usa il `targetLocale` dell'istanza quando `locale` viene omesso. Per eseguire ricerche senza un'istanza `GT`, consulta la versione standalone di [`getLocaleName`](/docs/platform/core/reference/utility-functions/locales/get-locale-name).*

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

### Lingua di visualizzazione

Il nome visualizzato viene localizzato in base a:

1. `sourceLocale` dell'istanza (se configurato).
2. All'impostazione regionale predefinita della libreria (`'en'`).

### Integrazione della mappatura personalizzata

* I mapping personalizzati delle impostazioni regionali vengono verificati per primi.
* Se è definito un nome personalizzato, questo ha la precedenza.
* In caso contrario, si usa `Intl.DisplayNames` per i codici BCP-47 standard.

### Impostazione regionale mancante

Genera un `Error` se non viene fornita alcuna impostazione regionale e nell'istanza non è configurato alcun `targetLocale`. Restituisce una stringa vuota se non viene trovato alcun nome per un'impostazione regionale valida.

## Parametri [#parameters]

| Parametro           | Descrizione                                                | Tipo     | Facoltativo | Predefinito         |
| ------------------- | ---------------------------------------------------------- | -------- | ----------- | ------------------- |
| [`locale`](#locale) | Codice locale BCP-47 di cui ottenere il nome visualizzato. | `string` | Sì          | `this.targetLocale` |

### `locale` [#locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `this.targetLocale`

Codice locale BCP-47 di cui ottenere il nome visualizzato. Se non specificato, viene usato `this.targetLocale` dell'istanza.

## Valore restituito [#returns]

**Tipo** `stringa`

Il nome visualizzato localizzato dell'impostazione regionale. Genera un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha un `targetLocale` configurato.

## Esempi [#examples]

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

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

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

## Note [#notes]

* Il metodo utilizza la `sourceLocale` dell'istanza per determinare la lingua di visualizzazione.
* I nomi delle mappature personalizzate hanno la precedenza rispetto a `Intl.DisplayNames`.