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

## 概要

`resolveAliasLocale` メソッドは、カスタムマッピングが設定されている場合、標準ロケールコードを元のエイリアスロケールコードに変換します。
これは `resolveCanonicalLocale` の逆の操作です。

***

## リファレンス

### パラメータ

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

### パラメータの説明

| パラメータ           | 説明                                   |
| --------------- | ------------------------------------ |
| `locale`        | 対応するエイリアスに逆引きするための標準ロケールコード          |
| `customMapping` | インスタンスのマッピングの代わりに使用する、省略可能なカスタムマッピング |

### 戻り値

`string` - マッピングが存在する場合はエイリアスロケールコード、そうでない場合は元のロケールコード

### スローされる例外

* `Error` - ロケールが指定されておらず、対象ロケールも設定されていない場合

***

## 例

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

// 標準ロケールをエイリアスに解決する
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// マッピングされていないロケールはそのまま返す
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"
```

***


## 注意事項

* カスタムマッピングがある場合は、元のエイリアスロケールコードを返します
* マッピングが見つからない場合は、入力されたロケールをそのまま返します

## 次のステップ

* [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)で標準ロケールを解決する
* [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)でロケールを検証する
* [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)でロケールのプロパティを取得する