# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/it/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale.mdx
---

title: resolveAliasLocale
description: Risolve un alias di impostazione regionale nel codice locale usato da una mappatura personalizzata senza un'istanza di GT. Riferimento API per resolveAliasLocale.

---

[`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) è una funzione di utilità indipendente della libreria Core di General Translation che riconverte un codice locale canonico nel relativo codice locale alias quando è configurata una mappatura personalizzata.

## Panoramica [#overview]

Importa `resolveAliasLocale` direttamente da `generaltranslation` e passagli un codice locale e una mappatura personalizzata. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente basato su istanza, usa invece il metodo [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) di un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' },
};

console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
```

Firma:

```typescript
resolveAliasLocale(locale: string, customMapping?: CustomMapping): string
```

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

* **Ricerca inversa.** Converte un codice locale canonico nell'alias mostrato all'utente definito in [`customMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Fallback.** Restituisce l'impostazione regionale originale se nella mappatura non esiste un alias corrispondente.
* **Senza stato.** Non ha effetti collaterali.

## Parametri [#parameters]

| Parametro                          | Descrizione                                         | Tipo                                                                  | Facoltativo | Predefinito |
| ---------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ----------- |
| [`locale`](#locale)                | Il codice locale canonico a cui associare un alias. | `string`                                                              | No          | —           |
| [`customMapping`](#custom-mapping) | La mappatura personalizzata usata per associare l'alias.  | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —           |

### `locale` [#locale]

**Type** `string` · **Obbligatorio**

Il codice locale canonico da associare a un alias.

### `customMapping` [#custom-mapping]

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facoltativo**

La mappatura personalizzata usata per risolvere l'alias. In assenza di una mappatura, l'impostazione regionale fornita in input viene restituita invariata.

## Valore restituito [#returns]

**Tipo** `string`

Il codice locale alias, se esiste una mappatura; altrimenti, l’impostazione regionale originale.

## Esempi [#examples]

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

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' },
};

// Risolve il canonical nell'alias
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// L'impostazione regionale non mappata restituisce il valore originale
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```

## Note [#notes]

* Converte i codici locale canonici in alias più comprensibili per l'utente.
* Restituisce l'impostazione regionale originale se non esiste alcuna mappatura.
* Essenziale per mostrare all'utente nomi di impostazioni regionali leggibili.
* Funziona con mappature personalizzate delle impostazioni regionali.
* Funzione senza stato — non ha effetti collaterali.