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

## 概要

`standardizeLocale` 関数は、GT クラスのインスタンスがなくても、BCP-47 ロケールコードの形式や大文字・小文字の表記を正しく標準化します。

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

// よくある書式の問題を修正する
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'

// すでに標準化されたロケールはそのまま通過する
console.log(standardizeLocale('es-ES')); // 'es-ES'
```

***


## リファレンス

### パラメータ

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

### 戻り値

`string` - 標準化された BCP-47 ロケールコード。無効な場合は空文字列

***

## 例

### ユーザー入力の処理

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

function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);
  
  return {
    original: input,
    standardized,
    isValid
  };
}

// さまざまな入力をテスト
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
  console.log(processUserInput(input));
});
```

***


## 補足

* アンダースコアをハイフンに変換します
* 大文字・小文字を正規化します (言語は小文字、地域は大文字) 
* 無効な形式の場合は空文字列を返します
* さまざまな入力元からのロケール入力を正規化するうえで重要です
* 外部依存はありません - 文字列操作のみで処理します

## 次のステップ

* GT クラスのメソッド [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale) を使用する
* [`isValidLocale`](/docs/core/functions/locales/is-valid-locale) で検証する