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

## Resumen

El método `standardizeLocale` estandariza un código de configuración regional BCP-47 para garantizar el formato correcto y el uso adecuado de mayúsculas y minúsculas.
Convierte los códigos de configuración regional a su formato canónico adecuado, para que puedan usarse con las API de internacionalización y mantener la coherencia en toda la aplicación.

***

## Referencia

### Parámetros

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

### Descripción de los parámetros

| Parámetro | Descripción                                                                                                                         |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | El código de configuración regional BCP-47 que se debe estandarizar. Si no se proporciona, se usa el `targetLocale` de la instancia |

### Devuelve

`string` - El código de configuración regional estandarizado según BCP-47, o una cadena vacía si la entrada no es válida

### Excepciones

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

***

## Comportamiento

Correcciones de formato comunes aplicadas:

* `en_US` → `en-US` (guion bajo por guion)
* `zh_cn` → `zh-CN` (guion bajo por guion, uso de mayúsculas y minúsculas)
* `EN-gb` → `en-GB` (idioma en minúsculas, región en mayúsculas)
* `Fr-ca` → `fr-CA` (uso correcto de mayúsculas y minúsculas en todo el código)
* `ja_jp` → `ja-JP` (guion bajo y uso de mayúsculas y minúsculas)

***

## Ejemplos

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es-ES'
});

// Estandarizar varios formatos de configuración regional
console.log(gt.standardizeLocale('en_us')); // "en-US"
console.log(gt.standardizeLocale('zh_cn')); // "zh-CN"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

// Las configuraciones regionales ya estandarizadas se mantienen sin cambios
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"
```

***


## Notas

* Convierte los guiones bajos en guiones y normaliza el uso de mayúsculas y minúsculas
* Devuelve una cadena vacía para los códigos de configuración regional no válidos
* Los códigos de idioma se convierten en minúsculas y los códigos de región, en mayúsculas
* Conserva las extensiones y variantes de la configuración regional cuando están presentes

## Siguientes pasos

* Validar configuraciones regionales estandarizadas con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Resolver configuraciones regionales canónicas con [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)
* Obtener las propiedades de la configuración regional con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)