# generaltranslation: General Translation Core SDK: resolveAliasLocale
URL: https://generaltranslation.com/zh/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) 转换为标准区域设置