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

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

---

Normalise un code de langue BCP-47 afin de garantir un format et une casse corrects sur une instance de [GT](/docs/platform/core/reference/gt-class/constructor). General Translation convertit les codes de langue en leur forme canonique, afin de les rendre cohérents dans l’ensemble de votre application et adaptés à une utilisation avec les API d’internationalisation.

## Vue d’ensemble [#overview]

Appelez `standardizeLocale` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) en lui passant éventuellement un code de langue. S’il n’est pas indiqué, la méthode utilise le `targetLocale` de l’instance.

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

console.log(gt.standardizeLocale('en-us')); // "en-US"
```

Signature :

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

*Remarque : `standardizeLocale` s’exécute localement et ne nécessite pas de clé API. Il utilise le `targetLocale` de l’instance lorsque `locale` n’est pas renseigné. Pour normaliser sans instance `GT`, consultez la version autonome de [`standardizeLocale`](/docs/platform/core/reference/utility-functions/locales/standardize-locale).*

## Fonctionnement [#how-it-works]

* **Canonicalisation.** S'appuie sur `Intl.getCanonicalLocales`, qui normalise la casse : les sous-balises de langue passent en minuscules et les sous-balises de région en majuscules.
* **Repli sur le paramètre régional.** Lorsque `locale` est omis, le `targetLocale` de l'instance est utilisé.
* **Retour inchangé en cas d'échec.** Renvoie la chaîne d'entrée telle quelle si elle ne peut pas être standardisée.
* **Paramètre régional manquant.** Lève une `Error` si aucun paramètre régional n'est fourni et que l'instance n'a pas de `targetLocale` configuré.

Corrections de casse courantes appliquées aux codes avec trait d'union :

* `en-us` → `en-US` (région en majuscules)
* `EN-gb` → `en-GB` (langue en minuscules, région en majuscules)
* `fr-ca` → `fr-CA` (casse correcte sur l'ensemble du code)

## Paramètres [#parameters]

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

### `locale` [#locale]

**Type** `string` · **Facultatif** · **Par défaut** `this.targetLocale`

Le code de langue BCP-47 à normaliser. S'il n'est pas fourni, la valeur `targetLocale` de l'instance est utilisée.

## Returns [#returns]

**Type** `string`

Le code de langue BCP-47 normalisé, ou la chaîne d’entrée inchangée si elle ne peut pas être normalisée. Génère une `Error` si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré.

## Exemples [#examples]

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

// La casse est normalisée pour les codes avec trait d'union
console.log(gt.standardizeLocale('en-us')); // "en-US"
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"
```

## Notes [#notes]

* Normalise la casse : les codes de langue passent en minuscules, les codes de région en majuscules.
* Renvoie la chaîne d’entrée inchangée lorsque le code ne peut pas être standardisé.
* Conserve les extensions et les variantes du paramètre régional lorsqu’elles sont présentes.