# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/ja/docs/core/functions/locales/is-valid-locale.mdx
---
title: isValidLocale
description: isValidLocale 関数の API リファレンス
---

## 概要

`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) でロケール形式を標準化する