# generaltranslation: General Translation Core SDK: standardizeLocale
URL: https://generaltranslation.com/es/docs/core/functions/locales/standardize-locale.mdx
---
title: standardizeLocale
description: Referencia de la API de la función standardizeLocale
---

## Resumen

La función `standardizeLocale` normaliza un código BCP-47 de configuración regional para garantizar el formato correcto y el uso adecuado de mayúsculas y minúsculas, sin necesidad de una instancia de la clase GT.

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

// Corregir problemas comunes de formato
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
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'
```

***


## Referencia

### Parámetros

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  }
}}
/>

### Devuelve

`string` - Código de configuración regional BCP-47 estandarizado o una cadena vacía si no es válido

***

## Ejemplos

### Procesamiento de la entrada del usuario

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

function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);
  
  return {
    original: input,
    standardized,
    isValid
  };
}

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

***


## Notas

* Convierte guiones bajos en guiones
* Normaliza el uso de mayúsculas y minúsculas (idioma en minúsculas, región en mayúsculas)
* Devuelve una cadena vacía para formatos no válidos
* Esencial para normalizar la entrada de configuración regional procedente de varios orígenes
* Sin dependencias externas; manipulación pura de cadenas

## Siguientes pasos

* Usa el método de la clase GT [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale)
* Valida con [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)