# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/es/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale.mdx
---

title: resolveAliasLocale
description: Resuelve un alias de configuración regional al código de configuración regional usado por un mapeo personalizado sin una instancia de GT. Referencia de la API de resolveAliasLocale.

---

[`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) es una función utilitaria independiente de la biblioteca principal de General Translation que convierte un código de configuración regional canónico de nuevo en su código de alias de configuración regional cuando hay un mapeo personalizado configurado.

## Descripción general [#overview]

Importa `resolveAliasLocale` directamente desde `generaltranslation` y llámalo con un código de configuración regional y un mapeo personalizado. No requiere una clave de API ni una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Para usar el equivalente basado en instancias, usa en su lugar el método [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) de una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor).

```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'
```

Firma:

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

## Cómo funciona [#how-it-works]

* **Búsqueda inversa.** Convierte un código de configuración regional canónico en el alias visible para el usuario definido en [`customMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Contenido alternativo.** Devuelve la configuración regional original si no existe ningún alias correspondiente en el mapeo.
* **Sin estado.** No tiene efectos secundarios.

## Parámetros [#parameters]

| Parámetro                          | Descripción                                                               | Tipo                                                                  | Opcional | Predeterminado |
| ---------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------- |
| [`locale`](#locale)                | El código de configuración regional canónico al que se resuelve un alias. | `string`                                                              | No       | —              |
| [`customMapping`](#custom-mapping) | El mapeo personalizado que se usa para resolver el alias.                 | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | —              |

### `locale` [#locale]

**Tipo** `string` · **Obligatorio**

El código canónico de configuración regional al que se resuelve un alias.

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

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Opcional**

El mapeo personalizado que se utiliza para resolver el alias. Si no hay ningún mapeo, se devuelve la configuración regional de entrada sin cambios.

## Devuelve [#returns]

**Tipo** `string`

El código de configuración regional del alias, si existe un mapeo; de lo contrario, la configuración regional original.

## Ejemplos [#examples]

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

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

// Resolver canónico a alias
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// La configuración regional sin mapeo devuelve el original
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```

## Notas [#notes]

* Convierte los códigos de configuración regional canónicos de nuevo en alias más fáciles de usar.
* Devuelve la configuración regional original si no existe ningún mapeo.
* Es esencial para mostrar nombres de configuración regional visibles para el usuario.
* Funciona con mapeos personalizados de configuración regional.
* Función sin estado, sin efectos secundarios.