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

title: resolveCanonicalLocale
description: Resuelve un alias de configuración regional a su código de configuración regional canónico sin una instancia de GT. Referencia de la API para resolveCanonicalLocale.

---

[`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale) es una función de utilidad independiente de la biblioteca Core de General Translation que resuelve un alias de configuración regional al código de configuración regional canónico BCP-47 que se usa internamente. Es la operación inversa de [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale).

## Descripción general [#overview]

Importa `resolveCanonicalLocale` directamente desde `generaltranslation` y llámalo con un código de configuración regional y, opcionalmente, un mapeo personalizado. No requiere una clave de API ni una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Si quieres resolverlo desde una instancia y heredar el mapeo de esa instancia, usa en su lugar el método [`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale) de una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

const canonical = resolveCanonicalLocale('en', { en: { code: 'en-US' } });
// "en-US"
```

Firma:

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

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

* **Búsqueda directa.** Busca la configuración regional canónica de un alias en [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Paso directo.** Devuelve la configuración regional de entrada sin cambios cuando no tiene un mapeo canónico.

## Parámetros [#parameters]

| Parámetro                          | Descripción                                                                           | Tipo                                                                  | Opcional | Predeterminado |
| ---------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------- |
| [`locale`](#locale)                | El código de configuración regional de alias que debe resolverse a su forma canónica. | `string`                                                              | No       | —              |
| [`customMapping`](#custom-mapping) | Mapeo personalizado que se utiliza para resolver la configuración regional canónica.  | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | —              |

### `locale` [#locale]

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

El código de configuración regional del alias que se va a resolver.

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

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

Mapeo personalizado para resolver la configuración regional canónica.

## Devuelve [#returns]

**Tipo** `string`

La configuración regional canónica del alias, o la configuración regional de entrada sin modificar si no existe un mapeo canónico.

## Ejemplos [#examples]

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

// Sin mapeo — devuelve la entrada sin cambios
console.log(resolveCanonicalLocale('en-US')); // "en-US"

// Con un mapeo personalizado — resuelve el alias
console.log(resolveCanonicalLocale('en', { en: { code: 'en-US' } })); // "en-US"
```

## Notas [#notes]

* Esta es la operación inversa de [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale).
* Devuelve la configuración regional de entrada sin cambios si no se encuentra ningún mapeo canónico.