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

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

---

[`standardizeLocale`](/docs/platform/core/reference/gt-class-methods/locales/standardize-locale) es una función utilitaria independiente de la biblioteca Core de General Translation que normaliza un código de configuración regional BCP-47 a su forma canónica y corrige el uso de mayúsculas y minúsculas.

## Resumen general [#overview]

Importa `standardizeLocale` directamente desde `generaltranslation` y llámalo con un código de configuración regional. No requiere una clave de API ni una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Si necesitas el equivalente basado en instancias, usa el método [`standardizeLocale`](/docs/platform/core/reference/gt-class-methods/locales/standardize-locale) de una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

// Normalizar mayúsculas y minúsculas
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'

// Las configuraciones regionales ya estandarizadas se pasan sin cambios
console.log(standardizeLocale('es-ES')); // 'es-ES'
```

Firma:

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

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

* **Canonicalización.** Pasa la entrada a `Intl.getCanonicalLocales` y devuelve el primer resultado canónico, que normaliza el uso de mayúsculas y minúsculas (idioma en minúsculas, región en mayúsculas y script con mayúscula inicial).
* **Fallback.** Si la entrada no se puede convertir a su forma canónica, se devuelve la cadena de entrada original sin cambios.

## Parámetros [#parameters]

| Parámetro           | Descripción                                                          | Tipo     | Opcional | Predeterminado |
| ------------------- | -------------------------------------------------------------------- | -------- | -------- | -------------- |
| [`locale`](#locale) | El código de configuración regional BCP-47 que se debe estandarizar. | `string` | No       | —              |

### `locale` [#locale]

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

El código de configuración regional BCP-47 que debe estandarizarse.

## Devuelve [#returns]

**Tipo** `string`

El código de configuración regional BCP-47 normalizado, o la cadena de entrada sin cambios si no puede normalizarse.

## Ejemplos [#examples]

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

// Normaliza las mayúsculas/minúsculas en etiquetas con guion
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'
console.log(standardizeLocale('en-us')); // 'en-US'

// Las configuraciones regionales ya estandarizadas se devuelven sin cambios
console.log(standardizeLocale('es-ES')); // 'es-ES'

// Las entradas no canonizables se devuelven sin modificar
console.log(standardizeLocale('en_us')); // 'en_us' (el guion bajo no es válido en BCP-47)
console.log(standardizeLocale('not a locale')); // 'not a locale'
```

```typescript
import { standardizeLocale, isValidLocale } from 'generaltranslation';

// Normalizar la entrada del usuario
function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);

  return {
    original: input,
    standardized,
    isValid,
  };
}

// Probar varias entradas
const inputs = ['EN-gb', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach((input) => {
  console.log(processUserInput(input));
});
```

## Notas [#notes]

* Normaliza el uso de mayúsculas y minúsculas (idioma en minúsculas, región en mayúsculas) mediante `Intl.getCanonicalLocales`.
* Devuelve la cadena de entrada sin cambios cuando no puede convertirse a una forma canónica.
* Esencial para normalizar la configuración regional de entrada procedente de distintas fuentes.
* Sin dependencias externas aparte de la API `Intl`.