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

## 概要

`resolveCanonicalLocale` メソッドは、ロケールのエイリアス (例: `cn` -> `zh`) を扱う際に使用され、カスタムマッピングが設定されている場合、エイリアスロケールコードを正規の BCP-47 ロケールコードに変換します。

***

## リファレンス

### パラメータ

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

### パラメータの説明

| パラメータ           | 説明                                                                |
| --------------- | ----------------------------------------------------------------- |
| `locale`        | 正規形式に解決するエイリアスロケールコード。指定しない場合は、インスタンスの `targetLocale` を使用します |
| `customMapping` | インスタンスのマッピングの代わりに使用する、任意のカスタムマッピング                                |

### 戻り値

`string` - マッピングが存在する場合は正規の BCP-47 ロケールコード、存在しない場合は元のロケールコード

### 例外

* `Error` - ロケールが指定されておらず、インスタンスに `targetLocale` も設定されていない場合

***

## 例

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: 'Mandarin' },
  }
});

// エイリアスを正規ロケールに変換する
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// 通常のBCP-47コードはそのまま渡される
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"
```

***


## 注意事項

* エイリアスロケールコードを正規の BCP-47 ロケールコードに変換します
* カスタムマッピングがない場合は、元のロケールを返します
* GT コンストラクターの `customMapping` 設定で動作します
* 入力または出力のロケールコードは検証されません

## 次のステップ

* [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale) でエイリアスを解決する
* [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale) でロケールを検証する
* [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale) でロケールの形式を標準化する