# generaltranslation: General Translation Core SDK: standardizeLocale
URL: https://generaltranslation.com/fr/docs/core/functions/locales/standardize-locale.mdx
---
title: standardizeLocale
description: Référence de l’API pour la fonction standardizeLocale
---

## Vue d’ensemble

La fonction `standardizeLocale` normalise un code de langue BCP-47 afin d’en garantir le formatage et les majuscules/minuscules corrects, sans qu’une instance de la classe GT soit nécessaire.

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

// Corriger les problèmes de formatage courants
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'

// Les paramètres régionaux déjà normalisés sont transmis tels quels
console.log(standardizeLocale('es-ES')); // 'es-ES'
```

***


## Référence

### Paramètres

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

### Renvoie

`string` - Code de langue BCP-47 normalisé, ou chaîne vide s’il est invalide

***

## Exemples

### Traitement des entrées utilisateur

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

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

// Tester différentes entrées
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
  console.log(processUserInput(input));
});
```

***


## Remarques

* Convertit les underscores en tirets
* Normalise la casse (langue en minuscules, région en majuscules)
* Renvoie une chaîne vide si le format est invalide
* Essentiel pour normaliser les entrées de paramètre régional provenant de diverses sources
* Aucune dépendance externe - simple manipulation de chaînes

## Étapes suivantes

* Utilisez la méthode de classe GT [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale)
* Vérifiez la validité avec [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)