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

## Panoramica

Il metodo `standardizeLocale` standardizza un codice locale BCP-47 per garantire formattazione e uso corretto di maiuscole e minuscole.
Converte i codici locale nel formato canonico corretto, rendendoli adatti all'uso con le API di internazionalizzazione e garantendo coerenza in tutta l'applicazione.

***

## Riferimento

### Parametri

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

### Descrizione dei parametri

| Parametro | Descrizione                                                                                                   |
| --------- | ------------------------------------------------------------------------------------------------------------- |
| `locale`  | Il codice locale BCP-47 da standardizzare. Se non specificato, viene usato il `targetLocale` dell&#39;istanza |

### Restituisce

`string` - Il codice locale BCP-47 standardizzato oppure una stringa vuota se l&#39;input non è valido

### Eccezioni

* `Error` - Se non viene fornita alcuna impostazione regionale e l&#39;istanza non ha alcun `targetLocale` configurato

***

## Comportamento

Correzioni di formato comuni applicate:

* `en_US` → `en-US` (da underscore a trattino)
* `zh_cn` → `zh-CN` (da underscore a trattino, maiuscole/minuscole)
* `EN-gb` → `en-GB` (lingua in minuscolo, regione in maiuscolo)
* `Fr-ca` → `fr-CA` (maiuscole/minuscole corrette in tutto)
* `ja_jp` → `ja-JP` (underscore e maiuscole/minuscole)

***

## Esempi

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es-ES'
});

// Standardizza vari formati di impostazione regionale
console.log(gt.standardizeLocale('en_us')); // "en-US"
console.log(gt.standardizeLocale('zh_cn')); // "zh-CN"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

// Le impostazioni regionali già standardizzate vengono passate invariate
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"
```

***


## Note

* Converte i trattini bassi in trattini e normalizza l&#39;uso di maiuscole e minuscole
* Restituisce una stringa vuota per i codici locale non validi
* I codici lingua diventano minuscoli, i codici regione diventano maiuscoli
* Mantiene estensioni e varianti dell&#39;impostazione regionale quando presenti

## Passaggi successivi

* Verifica le impostazioni regionali standardizzate con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Risolvi le impostazioni regionali canoniche con [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)
* Ottieni le proprietà dell&#39;impostazione regionale con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)