# generaltranslation: General Translation Core SDK: standardizeLocale
URL: https://generaltranslation.com/ru/docs/core/class/methods/locales/standardize-locale.mdx
---
title: standardizeLocale
description: Справка по API для метода GT standardizeLocale
---

## Обзор

Метод `standardizeLocale` стандартизирует код локали BCP-47, приводя его к правильному формату и регистру.
Он преобразует коды локалей в корректный канонический формат, чтобы их можно было использовать с API интернационализации и поддерживать единообразие во всём приложении.

***

## Справочник

### Параметры

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

### Описание параметров

| Параметр | Описание                                                                                                             |
| -------- | -------------------------------------------------------------------------------------------------------------------- |
| `locale` | Код локали BCP-47, который требуется стандартизировать. Если не указан, используется `targetLocale` этого экземпляра |

### Возвращает

`string` — стандартизированный код локали BCP-47 или пустую строку, если входные данные некорректны

### Выбрасывает

* `Error` — если локаль не указана и для экземпляра не задан `targetLocale`

***

## Поведение

Распространённые исправления формата:

* `en_US` → `en-US` (нижнее подчёркивание заменено на дефис)
* `zh_cn` → `zh-CN` (нижнее подчёркивание заменено на дефис, исправлен регистр)
* `EN-gb` → `en-GB` (код языка в нижнем регистре, код региона — в верхнем)
* `Fr-ca` → `fr-CA` (правильный регистр во всей записи)
* `ja_jp` → `ja-JP` (исправлены нижнее подчёркивание и регистр)

***

## Примеры

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

// Привести различные форматы локалей к стандартному виду
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"

// Уже стандартизированные локали передаются без изменений
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"
```

***


## Примечания

* Заменяет символы подчёркивания на дефисы и нормализует регистр
* Возвращает пустую строку для недопустимых кодов локали
* Коды языков приводятся к нижнему регистру, а коды регионов — к верхнему
* Сохраняет расширения и варианты локали, если они есть

## Следующие шаги

* Проверяйте, соответствует ли локаль стандарту, с помощью [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Определяйте канонические локали с помощью [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)
* Получайте свойства локали с помощью [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)