# generaltranslation: General Translation Core SDK: getLocaleName
URL: https://generaltranslation.com/it/docs/core/functions/locales/get-locale-name.mdx
---
title: getLocaleName
description: Riferimento API della funzione autonoma getLocaleName
---

## Panoramica

La funzione autonoma `getLocaleName` restituisce il nome visualizzato di un codice locale senza richiedere un'istanza della classe GT.
Usa l'API `Intl.DisplayNames` per fornire nomi localizzati delle impostazioni regionali per qualsiasi codice locale BCP-47 valido.

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

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

***


## Riferimento

### Parametri

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

### Descrizione dei parametri

| Parametro       | Descrizione                                                                                                    |
| --------------- | -------------------------------------------------------------------------------------------------------------- |
| `locale`        | Codice locale BCP-47 di cui ottenere il nome da visualizzare                                                   |
| `defaultLocale` | Impostazione regionale da usare per localizzare il nome da visualizzare (il valore predefinito è &#39;en&#39;) |
| `customMapping` | Mappatura personalizzata opzionale per codici locale e nomi                                                    |

### Restituisce

`string` - Il nome visualizzato localizzato per l&#39;impostazione regionale.

***

## Comportamento

### Risoluzione della lingua visualizzata

La funzione localizza i nomi secondo questo ordine di priorità:

1. parametro `defaultLocale` (se specificato)
2. impostazione regionale predefinita della libreria (&#39;en&#39;)

### Integrazione delle mappature personalizzate

* Le mappature personalizzate vengono verificati per primi sia per i codici locale sia per i nomi
* Supporta la risoluzione degli alias e i nomi visualizzati personalizzati
* Per i codici non mappati, usa `Intl.DisplayNames` standard

### Strategia di risoluzione dei nomi

1. **Nome della mappatura personalizzata** (priorità massima)
2. **Intl.DisplayNames** nell&#39;impostazione regionale predefinita
3. **Intl.DisplayNames** nell&#39;impostazione regionale predefinita della libreria (&#39;en&#39;)
4. **Codice locale stesso** (fallback)

***

## Esempi

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

// Nomi visualizzati in inglese
console.log(getLocaleName('es', 'en')); // "Spanish (Spain)"
console.log(getLocaleName('ja', 'en')); // "Japanese (Japan)"
console.log(getLocaleName('zh', 'en')); // "Chinese (China)"
```


### Generazione delle opzioni di impostazione regionale

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

function buildLocaleOptions(
  supportedLocales: string[],
  displayLocale: string = 'en'
) {
  return supportedLocales.map(locale => ({
    value: locale,
    label: getLocaleName(locale, displayLocale),
    emoji: getLocaleEmoji(locale)
  }));
}

const options = buildLocaleOptions([
  'en',
  'es',
  'fr',
  'de',
  'ja'
], 'en');

console.log(options);
// [
//   { value: 'en', label: 'English (United States)', emoji: '🇺🇸' },
//   { value: 'es', label: 'Spanish (Spain)', emoji: '🇪🇸' },
//   ...
// ]
```

***


## Note

* Le mappature personalizzate hanno la precedenza su `Intl.DisplayNames` standard
* Restituisce il codice locale stesso se non è possibile determinare un nome visualizzato
* Il parametro dell&#39;impostazione regionale di visualizzazione determina la lingua del nome restituito

## Passaggi successivi

* Ottieni l&#39;emoji dell&#39;impostazione regionale con [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)
* Usa il metodo della classe GT per le operazioni con stato [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Scopri il tipo [`CustomMapping`](/docs/core/types/custom-mapping)