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

title: standardizeLocale
description: Normalizza un codice locale in un formato standard. Riferimento API per standardizeLocale.

---

Standardizza un codice locale BCP-47 per garantirne la formattazione corretta e l'uso appropriato di maiuscole e minuscole in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). General Translation converte i codici locale nella loro forma canonica, rendendoli coerenti in tutta l'applicazione e adatti all'uso con le API di internazionalizzazione.

## Panoramica [#overview]

Chiama `standardizeLocale` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale facoltativo. Se non viene specificato, usa il `targetLocale` dell'istanza.

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

console.log(gt.standardizeLocale('en-us')); // "en-US"
```

Firma:

```typescript
standardizeLocale(locale?: string): string
```

*Nota: `standardizeLocale` viene eseguito localmente e non richiede una chiave API. Usa `targetLocale` dell'istanza quando `locale` viene omesso. Per la normalizzazione senza un'istanza `GT`, vedi la versione autonoma di [`standardizeLocale`](/docs/platform/core/reference/utility-functions/locales/standardize-locale).*

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

* **Canonicalizzazione.** Delega a `Intl.getCanonicalLocales`, che normalizza l'uso di maiuscole e minuscole: i sottotag della lingua diventano minuscoli e quelli della regione maiuscoli.
* **Fallback dell'impostazione regionale.** Quando `locale` viene omesso, viene usato `targetLocale` dell'istanza.
* **Passthrough in caso di errore.** Restituisce la stringa di input invariata se non può essere standardizzata.
* **Impostazione regionale mancante.** Genera un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha `targetLocale` configurato.

Correzioni comuni di maiuscole e minuscole applicate ai codici con trattino:

* `en-us` → `en-US` (regione in maiuscolo)
* `EN-gb` → `en-GB` (lingua in minuscolo, regione in maiuscolo)
* `fr-ca` → `fr-CA` (maiuscole e minuscole corrette in tutto il codice)

## Parametri [#parameters]

| Parametro           | Descrizione                                | Tipo     | Facoltativo | Predefinito         |
| ------------------- | ------------------------------------------ | -------- | ----------- | ------------------- |
| [`locale`](#locale) | Il codice locale BCP-47 da standardizzare. | `string` | Sì          | `this.targetLocale` |

### `locale` [#locale]

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

Il codice locale BCP-47 da standardizzare. Se non viene specificato, viene usato il `targetLocale` dell'istanza.

## Restituisce [#returns]

**Tipo** `string`

Il codice locale BCP-47 standardizzato, oppure la stringa di input invariata se non può essere standardizzata. Genera un `Error` se non viene fornita alcuna impostazione regionale e per l'istanza non è configurato alcun `targetLocale`.

## Esempi [#examples]

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

// Le maiuscole e minuscole vengono normalizzate per i codici con trattino
console.log(gt.standardizeLocale('en-us')); // "en-US"
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 [#notes]

* Normalizza maiuscole e minuscole: i codici lingua diventano minuscoli, i codici regione diventano maiuscoli.
* Restituisce la stringa di input invariata quando il codice non può essere standardizzato.
* Mantiene estensioni e varianti dell'impostazione regionale, se presenti.