Utility FunctionsLocales

standardizeLocale

Riferimento API alla funzione standardizeLocale

Panoramica

La funzione standardizeLocale normalizza un codice locale BCP‑47 per garantire formattazione e maiuscole/minuscole corrette, senza richiedere un'istanza della classe GT.

import { standardizeLocale } from 'generaltranslation';

// Corregge i problemi di formattazione più comuni
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'

// Le locale già standardizzate passano senza modifiche
console.log(standardizeLocale('es-ES')); // 'es-ES'

Riferimenti

Parametri

Prop

Type

Restituisce

string - Codice locale BCP-47 normalizzato oppure stringa vuota se non valido


Esempi

Elaborazione dell’input dell’utente

import { standardizeLocale, isValidLocale } from 'generaltranslation';

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

// Test di vari input
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
  console.log(processUserInput(input));
});

Note

  • Converte gli underscore in trattini
  • Normalizza le maiuscole/minuscole (lingua in minuscolo, regione in maiuscolo)
  • Restituisce una stringa vuota per formati non validi
  • Essenziale per normalizzare gli input di locale da varie fonti
  • Nessuna dipendenza esterna: pura manipolazione di stringhe

Passaggi successivi

Come valuti questa guida?

standardizeLocale