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

## Vue d’ensemble

La méthode `standardizeLocale` standardise un code de langue BCP-47 afin de garantir un formatage et une casse corrects.
Elle convertit les codes de langue dans leur format canonique approprié pour qu’ils puissent être utilisés avec les API d’internationalisation et pour assurer la cohérence dans l’ensemble de votre application.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale'
  }
}}
/>

### Description des paramètres

| Paramètre | Description                                                                                                                     |
| --------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | Le code de langue BCP-47 du paramètre régional à normaliser. S’il n’est pas fourni, le `targetLocale` de l’instance est utilisé |

### Renvoie

`string` - Le code de langue BCP-47 normalisé, ou une chaîne vide si l’entrée n’est pas valide

### Déclenche

* `Error` - Si aucun paramètre régional n’est fourni et qu’aucun `targetLocale` n’est configuré pour l’instance

***

## Comportement

Corrections de format couramment appliquées :

* `en_US` → `en-US` (underscore remplacé par un trait d’union)
* `zh_cn` → `zh-CN` (underscore remplacé par un trait d’union, casse corrigée)
* `EN-gb` → `en-GB` (langue en minuscules, région en majuscules)
* `Fr-ca` → `fr-CA` (casse corrigée dans l’ensemble)
* `ja_jp` → `ja-JP` (underscore remplacé par un trait d’union, casse corrigée)

***

## Exemples

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

// Normaliser différents formats de paramètres régionaux
console.log(gt.standardizeLocale('en_us')); // "en-US"
console.log(gt.standardizeLocale('zh_cn')); // "zh-CN"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

// Les paramètres régionaux déjà normalisés sont transmis sans modification
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"
```

***


## Remarques

* Convertit les tirets bas en traits d’union et normalise la casse
* Renvoie une chaîne vide pour les codes de langue non valides
* Les codes de langue sont mis en minuscules, les codes de région en majuscules
* Préserve les extensions et les variantes du paramètre régional lorsqu’elles sont présentes

## Étapes suivantes

* Validez les paramètres régionaux normalisés avec [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Résolvez les paramètres régionaux standard avec [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)
* Récupérez les propriétés d’un paramètre régional avec [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)