Utility FunctionsLocales

standardizeLocale

Referencia de API de la función standardizeLocale

Descripción general

La función standardizeLocale normaliza un código de configuración regional BCP-47 para asegurar el formato y el uso de mayúsculas/minúsculas correctos, sin requerir una instancia de la clase GT.

import { standardizeLocale } from 'generaltranslation';

// Corrige problemas de formato comunes
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'

// Los locales ya estandarizados pasan sin cambios
console.log(standardizeLocale('es-ES')); // 'es-ES'

Referencia

Parámetros

Prop

Type

Devuelve

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


Ejemplos

Procesamiento de la entrada de usuario

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 las mayúsculas/minúsculas (idioma en minúsculas, región en mayúsculas)
  • Devuelve una cadena vacía para formatos no válidos
  • Es esencial para normalizar la entrada de locale desde diversas fuentes
  • Sin dependencias externas: manipulación de cadenas pura

Próximos pasos

¿Qué te ha parecido esta guía?

standardizeLocale