# generaltranslation: General Translation Core SDK: resolveAliasLocale
URL: https://generaltranslation.com/zh/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) 获取区域设置属性