# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/ru/docs/core/functions/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Справка по API для функции isValidLocale
---

## Обзор

Функция `isValidLocale` проверяет, является ли заданная строка корректным кодом локали BCP-47. Она выполняет полную проверку формата без необходимости создавать экземпляр класса GT.

***

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

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

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

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

`boolean` — `true`, если код локали корректен, иначе `false`

***

## Примеры

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

// Допустимые коды локали
console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('zh-CN')); // true
console.log(isValidLocale('es')); // true

// Недопустимые коды локали
console.log(isValidLocale('invalid')); // false
console.log(isValidLocale('en_US')); // false (подчёркивание вместо дефиса)
console.log(isValidLocale('')); // false
```

***


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

* Проверяет формат кода локали BCP-47
* Работает с пользовательскими сопоставлениями локалей
* Необходима для валидации пользовательского ввода
* Без сетевых запросов — только проверка формата
* Функция без состояния, подходящая для утилитарных библиотек

## Что дальше

* Используйте метод класса GT [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Приведите формат к стандартному виду с помощью [`standardizeLocale`](/docs/core/functions/locales/standardize-locale)