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

## 概要

`resolveAliasLocale` 関数は、カスタムマッピングが設定されている場合、正規ロケールコードを対応するエイリアスロケールコードに戻します。このスタンドアロン関数は、インスタンスを作成しなくても GT クラスメソッドと同じ機能を提供します。

***

## リファレンス

### パラメーター

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

### 戻り値

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

***

## 例

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

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' }
};

// 正規ロケールコードをエイリアスロケールに解決
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// マッピングされていないロケールは元の値を返す
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```

***


## 注記

* 正規ロケールコードをわかりやすいエイリアスに戻します
* マッピングが存在しない場合は元のロケールを返します
* ユーザー向けロケール名の表示に不可欠です
* カスタムのロケールマッピングにも対応します
* ステートレスな関数で、副作用はありません

## 次のステップ

* GT クラスメソッド [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale) を使用する
* [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale) を使って正規形に変換する