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

title: resolveCanonicalLocale
description: Risolve un alias di impostazione regionale nel relativo codice locale canonico senza un'istanza GT. Riferimento API per resolveCanonicalLocale.

---

[`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale) è una funzione di utilità autonoma della libreria Core di General Translation che risolve un alias di impostazione regionale nel codice locale canonico BCP-47 usato internamente. È l'inverso di [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale).

## Panoramica [#overview]

Importa `resolveCanonicalLocale` direttamente da `generaltranslation` e chiamalo con un codice locale e, facoltativamente, una mappatura personalizzata. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per una risoluzione basata su un'istanza che eredita la mappatura dell'istanza, usa invece il metodo [`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale) su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

const canonical = resolveCanonicalLocale('en', { en: { code: 'en-US' } });
// "en-US"
```

Firma:

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

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

* **Ricerca diretta.** Recupera l'impostazione regionale canonica di un alias da [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Passthrough.** Restituisce l'impostazione regionale di input invariata quando non esiste una mappatura canonica.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                                           | Tipo                                                                  | Facoltativo | Predefinito |
| ---------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ----------- |
| [`locale`](#locale)                | Il codice locale alias da ricondurre alla sua forma canonica.                         | `string`                                                              | No          | —           |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata usata per determinare l'impostazione regionale canonica. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —           |

### `locale` [#locale]

**Tipo** `string` · **Obbligatorio**

Il codice locale dell'alias da risolvere.

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

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

Mappatura personalizzata utilizzata per determinare l'impostazione regionale canonica.

## Restituisce [#returns]

**Tipo** `string`

L'impostazione regionale canonica dell'alias, oppure l'impostazione regionale di input invariata se non esiste una mappatura canonica.

## Esempi [#examples]

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

// Nessun mapping — restituisce l'input invariato
console.log(resolveCanonicalLocale('en-US')); // "en-US"

// Con una mappatura personalizzata — risolve l'alias
console.log(resolveCanonicalLocale('en', { en: { code: 'en-US' } })); // "en-US"
```

## Note [#notes]

* È l'inverso di [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale).
* Restituisce l'impostazione regionale di input invariata se non trova alcuna mappatura canonica.