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

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

---

Risolve un alias di impostazione regionale nel codice locale canonico BCP-47 usato internamente, in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Questo è l'inverso di [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale). General Translation usa una mappatura personalizzata, così puoi esporre i tuoi codici locali durante la traduzione e la formattazione usando internamente codici standard.

## Panoramica [#overview]

Chiama `resolveCanonicalLocale` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale. Restituisce l'impostazione regionale canonica quando il codice è un alias configurato; altrimenti restituisce invariata l'impostazione regionale di input.

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    cn: { code: 'zh', name: 'Mandarin' },
  },
});

const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"
```

Firma:

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

*Nota: `resolveCanonicalLocale` viene eseguita localmente e non richiede una chiave API. Usa l'impostazione regionale di destinazione dell'istanza e `customMapping` quando gli argomenti sono omessi. Per la risoluzione senza un'istanza `GT`, vedi la versione autonoma di [`resolveCanonicalLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-canonical-locale).*

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

* **Risoluzione diretta.** Cerca l'impostazione regionale canonica per un alias in [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Pass-through.** Restituisce l'impostazione regionale di input invariata se non esiste una mappatura canonica.
* **Fallback dell'istanza.** Quando `locale` viene omesso, viene usata l'impostazione regionale di destinazione dell'istanza; quando `customMapping` viene omesso, viene usato il `customMapping` dell'istanza.
* **Genera un errore** quando non è disponibile alcuna impostazione regionale (né un argomento né l'impostazione regionale di destinazione dell'istanza).

## Parametri [#parameters]

| Parametro                          | Descrizione                                                            | Tipo                                                                  | Facoltativo | Predefinito          |
| ---------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | -------------------- |
| [`locale`](#locale)                | Il codice locale alias da risolvere nella sua forma canonica.          | `string`                                                              | Sì          | `this.targetLocale`  |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata da usare al posto di quella dell'istanza. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | `this.customMapping` |

### `locale` [#locale]

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

L'alias del codice locale da risolvere. Se omesso, viene usata come fallback l'impostazione regionale di destinazione dell'istanza.

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

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

Mappatura personalizzata da utilizzare al posto della mappatura dell'istanza.

## Restituisce [#returns]

**Tipo** `string`

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

## Esempi [#examples]

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    cn: { code: 'zh', name: 'Mandarin' },
  },
});

// Risolve l'alias nell'impostazione regionale canonica
console.log(gt.resolveCanonicalLocale('cn')); // "zh"

// Un'impostazione regionale senza mapping restituisce l'originale
console.log(gt.resolveCanonicalLocale('es')); // "es"
```

## Note [#notes]

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