# generaltranslation: General Translation Core SDK: standardizeLocale
URL: https://generaltranslation.com/ja/docs/core/class/methods/locales/standardize-locale.mdx
---
title: standardizeLocale
description: GT の standardizeLocale メソッドの API リファレンス
---

## 概要

`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) でロケールのプロパティを取得する