# generaltranslation: General Translation Core SDK: resolveCanonicalLocale
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/resolve-canonical-locale.mdx
---
title: resolveCanonicalLocale
description: Referencia de la API para el método resolveCanonicalLocale de GT
---

## Descripción general

En el contexto de los alias de configuración regional (p. ej., `cn` -> `zh`), el método `resolveCanonicalLocale` convierte los códigos alias de configuración regional en sus códigos canónicos de configuración regional BCP-47 cuando se ha configurado un mapeo personalizado.

***

## Referencia

### Parámetros

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Descripción de los parámetros

| Parámetro       | Descripción                                                                                                                                        |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`        | El código alias de configuración regional que se debe resolver a su forma canónica. Si no se proporciona, se usa el `targetLocale` de la instancia |
| `customMapping` | Mapeo personalizado opcional que se usará en lugar del mapeo de la instancia                                                                       |

### Devuelve

`string` - El código de configuración regional canónico en formato BCP-47 si existe un mapeo; de lo contrario, el código de configuración regional original

### Lanza

* `Error` - Si no se proporciona ninguna configuración regional y la instancia no tiene configurado `targetLocale`

***

## Ejemplos

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: 'Mandarin' },
  }
});

// Convertir alias a configuración regional canónica
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Los códigos BCP-47 regulares pasan sin cambios
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"
```

***


## Notas

* Convierte códigos alias de configuración regional en códigos canónicos BCP-47 de configuración regional
* Devuelve la configuración regional original si no existe ninguna asignación personalizada
* Funciona con la configuración `customMapping` del constructor de GT
* No se realiza ninguna validación de los códigos de configuración regional de entrada ni de salida

## Próximos pasos

* Volver a resolver como alias con [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Validar configuraciones regionales con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Estandarizar el formato de la configuración regional con [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale)