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

title: standardizeLocale
description: Normaliser un code de langue dans un format standard sans instance GT. Référence API de standardizeLocale.

---

[`standardizeLocale`](/docs/platform/core/reference/gt-class-methods/locales/standardize-locale) est une fonction utilitaire autonome de la bibliothèque Core de General Translation qui normalise un code de langue BCP-47 dans sa forme canonique en corrigeant la casse.

## Vue d’ensemble [#overview]

Importez `standardizeLocale` directement depuis `generaltranslation` et appelez-la avec un code de langue. Elle ne nécessite ni clé API ni instance de [GT](/docs/platform/core/reference/gt-class/constructor). Pour l’équivalent sous forme de méthode d’instance, utilisez plutôt la méthode [`standardizeLocale`](/docs/platform/core/reference/gt-class-methods/locales/standardize-locale) d’une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

// Normaliser la casse
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'
```

Signature :

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

## Fonctionnement [#how-it-works]

* **Canonicalisation.** Passe l’entrée à `Intl.getCanonicalLocales` et renvoie le premier résultat canonique, ce qui normalise la casse (langue en minuscules, région en majuscules, script avec une majuscule initiale).
* **Contenu de secours.** Si l’entrée ne peut pas être mise sous forme canonique, la chaîne d’origine est renvoyée inchangée.

## Paramètres [#parameters]

| Paramètre           | Description                              | Type     | Facultatif | Par défaut |
| ------------------- | ---------------------------------------- | -------- | ---------- | ---------- |
| [`locale`](#locale) | Le code de langue BCP-47 à standardiser. | `string` | Non        | —          |

### `locale` [#locale]

**Type** `string` · **Obligatoire**

Le code de langue BCP-47 à standardiser.

## Valeur de retour [#returns]

**Type** `string`

Le code de langue BCP-47 normalisé, ou la chaîne d’entrée telle quelle si elle ne peut pas être normalisée.

## Exemples [#examples]

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

// Normalise la casse des tags avec trait d'union
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'
console.log(standardizeLocale('en-us')); // 'en-US'

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

// Les entrées non canonicalisables sont renvoyées sans modification
console.log(standardizeLocale('en_us')); // 'en_us' (le tiret bas n'est pas valide en BCP-47)
console.log(standardizeLocale('not a locale')); // 'not a locale'
```

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

// Normalisation de la saisie utilisateur
function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);

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

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

## Remarques [#notes]

* Normalise la casse (langue en minuscules, région en majuscules) via `Intl.getCanonicalLocales`.
* Renvoie la chaîne d’entrée inchangée si l’entrée ne peut pas être mise sous forme canonique.
* Essentiel pour normaliser les paramètres régionaux provenant de diverses sources.
* Aucune dépendance externe en dehors de l’API `Intl`.