# General Translation Platform: standardizeLocale
URL: https://generaltranslation.com/es/docs/platform/core/reference/gt-class-methods/locales/standardize-locale.mdx
---

title: standardizeLocale
description: Normaliza un código de configuración regional a un formato estándar. Referencia de la API para standardizeLocale.

---

Estandariza un código de configuración regional BCP-47 para garantizar el formato y uso de mayúsculas y minúsculas correctos en una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). General Translation convierte los códigos de configuración regional a su forma canónica, lo que los hace coherentes en toda tu aplicación y aptos para usarse con las API de internacionalización.

## Resumen general [#overview]

Llama a `standardizeLocale` en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) con un código de configuración regional opcional. Si se omite, se usa el `targetLocale` de la instancia.

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

console.log(gt.standardizeLocale('en-us')); // "en-US"
```

Firma:

```typescript
standardizeLocale(locale?: string): string
```

*Nota: `standardizeLocale` se ejecuta localmente y no requiere una API Key. Usa el `targetLocale` de la instancia cuando se omite `locale`. Para normalizar sin una instancia de `GT`, consulta la opción standalone de [`standardizeLocale`](/docs/platform/core/reference/utility-functions/locales/standardize-locale).*

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

* **Canonicalización.** Delega en `Intl.getCanonicalLocales`, que normaliza el uso de mayúsculas y minúsculas: las subetiquetas de idioma se convierten en minúsculas y las subetiquetas de región en mayúsculas.
* **Configuración regional de respaldo.** Cuando se omite `locale`, se usa el `targetLocale` de la instancia.
* **Sin cambios en caso de error.** Devuelve la cadena de entrada sin cambios si no se puede estandarizar.
* **Falta la configuración regional.** Lanza un `Error` si no se proporciona ninguna configuración regional y la instancia no tiene `targetLocale` configurado.

Correcciones habituales de mayúsculas y minúsculas aplicadas a códigos con guion:

* `en-us` → `en-US` (región en mayú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)

## Parámetros [#parameters]

| Parámetro           | Descripción                                                          | Type     | Opcional | Predeterminado      |
| ------------------- | -------------------------------------------------------------------- | -------- | -------- | ------------------- |
| [`locale`](#locale) | El código de configuración regional BCP-47 que se debe estandarizar. | `string` | Sí       | `this.targetLocale` |

### `locale` [#locale]

**Tipo** `string` · **Opcional** · **Predeterminado** `this.targetLocale`

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 [#returns]

**Tipo** `string`

El código de configuración regional BCP-47 estandarizado, o la cadena de entrada sin cambios si no puede estandarizarse. Lanza un `Error` si no se proporciona ninguna configuración regional y la instancia no tiene configurado `targetLocale`.

## Ejemplos [#examples]

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

// El uso de mayúsculas y minúsculas se normaliza para los códigos con guión
console.log(gt.standardizeLocale('en-us')); // "en-US"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

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

## Notas [#notes]

* Normaliza el uso de mayúsculas y minúsculas: los códigos de idioma se convierten a minúsculas y los códigos de región, a mayúsculas.
* Devuelve la cadena de entrada sin cambios cuando el código no puede estandarizarse.
* Conserva las extensiones y variantes de la configuración regional cuando están presentes.