# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/ja/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale.mdx
---

title: resolveAliasLocale
description: カスタムマッピング で使用されるロケールコードに エイリアス ロケールコードを解決します。resolveAliasLocale の API リファレンス。

---

カスタムマッピング が設定されている場合、[GT](/docs/platform/core/reference/gt-class/constructor) インスタンスで、正規ロケールコードを元の エイリアス ロケールコードに戻します。これは [`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale) の逆の操作です。General Translation では aliases を使用することで、独自のロケールコードを公開しつつ、内部ではそれらを標準の BCP-47 コードに対応付けられます。

## 概要 [#overview]

正規ロケールコードを指定して、[`GT`](/docs/platform/core/reference/gt-class/constructor) インスタンスに対して `resolveAliasLocale` を呼び出します。対応するエイリアスが設定されていればそのエイリアスを返し、設定されていなければ入力したロケールをそのまま返します。

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

const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"
```

シグネチャ:

```typescript
resolveAliasLocale(
  locale: string,
  customMapping?: CustomMapping
): string
```

*注記: `resolveAliasLocale` はローカルで実行されるため、APIキーは不要です。`customMapping` を省略した場合は、インスタンスの `customMapping` が使用されます。`GT` インスタンスを使わずに解決する場合は、スタンドアロンの [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale) を参照してください。*

## 動作の仕組み [#how-it-works]

* **逆引き。** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) で、正規ロケールに対して設定されたエイリアスを参照します。
* **そのまま返す。** 入力ロケールがすでにエイリアスである場合、またはエイリアスのマッピングが存在しない場合は、入力ロケールをそのまま返します。
* **マッピングのフォールバック。** `customMapping` が省略されている場合は、インスタンスの `customMapping` が使用されます。

## パラメータ [#parameters]

| パラメータ                              | 説明                              | 型                                                                     | 任意  | デフォルト                |
| ---------------------------------- | ------------------------------- | --------------------------------------------------------------------- | --- | -------------------- |
| [`locale`](#locale)                | エイリアスに逆引きする正規ロケールコード。           | `string`                                                              | いいえ | —                    |
| [`customMapping`](#custom-mapping) | インスタンスのマッピングの代わりに使用するカスタムマッピング。 | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | はい  | `this.customMapping` |

### `locale` [#locale]

**型** `string` · **必須**

エイリアスが参照する正規ロケールコード。

### `customMapping` [#custom-mapping]

**型** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **任意** · **デフォルト** `this.customMapping`

インスタンスのマッピングの代わりに使用するカスタムマッピング。

## 戻り値 [#returns]

**型** `string`

正規ロケールに設定されたエイリアスを返します。入力されたロケールがすでにエイリアスである場合、またはエイリアスの対応付けが存在しない場合は、そのロケールをそのまま返します。

## 例 [#examples]

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

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

// mappingされていないロケールは元の値を返す
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"
```

## メモ [#notes]

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