# 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
---

## Resumen

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

***

## 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 del alias de configuración regional que debe resolverse a su forma canónica. Si no se proporciona, usa el `targetLocale` de la instancia |
| `customMapping` | Asignación personalizada opcional que se usará en lugar de la de la instancia                                                                      |

### Devuelve

`cadena` - El código canónico de configuración regional BCP-47 si existe una correspondencia; 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 estándar pasan sin modificaciones
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"
```

***


## Notas

* Convierte códigos de alias de configuración regional a códigos canónicos de configuración regional BCP-47
* Devuelve la configuración regional original si no existe una 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 o de salida

## Próximos pasos

* Volver a convertir a alias con [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Validar locales 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)