# generaltranslation: General Translation Core SDK: resolveCanonicalLocale
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/resolve-canonical-locale.mdx
---
title: resolveCanonicalLocale
description: Riferimento dell’API per il metodo resolveCanonicalLocale di GT
---

## Panoramica

Usato nel contesto degli alias delle impostazioni regionali (ad es. `cn` -> `zh`), il metodo `resolveCanonicalLocale` converte i codici locali alias nei corrispondenti codici locali canonici BCP-47 quando è configurata una mappatura personalizzata.

***

## Riferimento

### Parametri

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Descrizione dei parametri

| Parametro       | Descrizione                                                                                                                                   |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`        | Il codice locale alias da risolvere nella forma canonica. Se non specificato, usa il `targetLocale` dell&#39;istanza |
| `customMapping` | Mapping personalizzato facoltativo da usare al posto di quello dell&#39;istanza                                                               |

### Restituisce

`string` - Il codice locale canonico BCP-47, se esiste una mappatura; altrimenti, il codice locale originale

### Eccezioni

* `Error` - Se non viene specificata alcuna impostazione regionale e per l&#39;istanza non è configurato `targetLocale`

***

## Esempi

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

// Converti l'alias nell'impostazione regionale canonica
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// I codici BCP-47 standard passano invariati
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"
```

***


## Note

* Converte i codici locale alias in codici locale BCP-47 canonici
* Restituisce l&#39;impostazione regionale originale se non è definita alcuna mappatura personalizzata
* Funziona con la configurazione `customMapping` del costruttore GT
* Non viene eseguita alcuna validazione sui codici locale di input o output

## Passaggi successivi

* Riconduci agli alias con [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Convalida le impostazioni regionali con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Standardizza il formato dell&#39;impostazione regionale con [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale)