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

title: standardizeLocale
description: Normalizza un codice locale in un formato standard senza un'istanza GT. Riferimento API di standardizeLocale.

---

[`standardizeLocale`](/docs/platform/core/reference/gt-class-methods/locales/standardize-locale) è una funzione di utilità indipendente della libreria Core di General Translation che normalizza un codice locale BCP-47 nella sua forma canonica, correggendo maiuscole e minuscole.

## Panoramica [#overview]

Importa `standardizeLocale` direttamente da `generaltranslation` e chiamalo con un codice locale. Non richiede una chiave API né un'istanza [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente che usa un'istanza, utilizza invece il metodo [`standardizeLocale`](/docs/platform/core/reference/gt-class-methods/locales/standardize-locale) su un'istanza [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

// Normalizza le maiuscole/minuscole
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'

// Le impostazioni regionali già standardizzate vengono restituite invariate
console.log(standardizeLocale('es-ES')); // 'es-ES'
```

Firma:

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

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

* **Canonicalizzazione.** Passa l'input a `Intl.getCanonicalLocales` e restituisce il primo risultato canonico, normalizzando l'uso di maiuscole e minuscole (lingua in minuscolo, regione in maiuscolo, sistema di scrittura con iniziale maiuscola).
* **Fallback.** Se l'input non può essere reso canonico, la stringa di input originale viene restituita invariata.

## Parametri [#parameters]

| Parametro           | Descrizione                                | Tipo      | Facoltativo | Predefinito |
| ------------------- | ------------------------------------------ | --------- | ----------- | ----------- |
| [`locale`](#locale) | Il codice locale BCP-47 da standardizzare. | `stringa` | No          | —           |

### `locale` [#locale]

**Tipo** `stringa` · **Obbligatorio**

Codice locale BCP-47 da standardizzare.

## Valore restituito [#returns]

**Tipo** `stringa`

Il codice locale BCP-47 standardizzato oppure, se non può essere standardizzato, la stringa di input invariata.

## Esempi [#examples]

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

// Normalizza le maiuscole/minuscole nei tag con trattino
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'
console.log(standardizeLocale('en-us')); // 'en-US'

// Le impostazioni regionali già standardizzate vengono restituite invariate
console.log(standardizeLocale('es-ES')); // 'es-ES'

// L'input non canonicalizzabile viene restituito invariato
console.log(standardizeLocale('en_us')); // 'en_us' (il trattino basso non è valido in BCP-47)
console.log(standardizeLocale('not a locale')); // 'not a locale'
```

```typescript
import { standardizeLocale, isValidLocale } from 'generaltranslation';

// Normalizzazione dell'input utente
function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);

  return {
    original: input,
    standardized,
    isValid,
  };
}

// Test di vari input
const inputs = ['EN-gb', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach((input) => {
  console.log(processUserInput(input));
});
```

## Note [#notes]

* Normalizza l'uso di maiuscole e minuscole (lingua in minuscolo, regione in maiuscolo) tramite `Intl.getCanonicalLocales`.
* Restituisce invariata la stringa di input per i valori che non possono essere convertiti in forma canonica.
* Essenziale per normalizzare l'input dell'impostazione regionale proveniente da varie fonti.
* Nessuna dipendenza esterna oltre all'API `Intl`.