# generaltranslation: General Translation Core SDK: standardizeLocale
URL: https://generaltranslation.com/it/docs/core/functions/locales/standardize-locale.mdx
---
title: standardizeLocale
description: Riferimento dell'API per la funzione standardizeLocale
---

## Panoramica

La funzione `standardizeLocale` standardizza un codice locale BCP-47 per garantire la formattazione corretta e l'uso corretto di maiuscole e minuscole, senza richiedere un'istanza della classe GT.

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

// Correggi i problemi di formattazione comuni
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'

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

***


## Riferimento

### Parametri

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  }
}}
/>

### Restituisce

`string` - Codice locale BCP-47 standardizzato oppure stringa vuota se non valido

***

## Esempi

### Elaborazione dell’input utente

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

function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);
  
  return {
    original: input,
    standardized,
    isValid
  };
}

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

***


## Note

* Converte gli underscore in trattini
* Normalizza l&#39;uso di maiuscole e minuscole (lingua in minuscolo, regione in maiuscolo)
* Restituisce una stringa vuota per i formati non validi
* Essenziale per normalizzare l&#39;input dell&#39;impostazione regionale proveniente da diverse fonti
* Nessuna dipendenza esterna: semplice manipolazione di stringhe

## Passaggi successivi

* Usa il metodo [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale) della classe GT
* Verifica con [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)