Panoramica

Il metodo standardizeLocale normalizza un codice locale BCP‑47 per garantirne il formato e il casing corretti. Converte i codici locale nel relativo formato canonico, rendendoli idonei all’uso con le API di internazionalizzazione e assicurando coerenza in tutta l’applicazione.

Riferimenti

Parametri

Descrizione dei parametri

Restituisce

string - Il codice locale BCP-47 standardizzato, oppure una stringa vuota se l’input non è valido

Eccezioni generate

• Error - Se non viene fornito alcun locale e l’istanza non ha un targetLocale configurato

Comportamento

Correzioni di formato comuni applicate:

• en_US → en-US (sottolineatura in trattino)
• zh_cn → zh-CN (sottolineatura in trattino, uso corretto di maiuscole/minuscole)
• EN-gb → en-GB (lingua in minuscolo, regione in maiuscolo)
• Fr-ca → fr-CA (uso corretto delle maiuscole/minuscole)
• ja_jp → ja-JP (sottolineatura e maiuscole/minuscole)

Esempi

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

// Uniforma diversi formati di locale
console.log(gt.standardizeLocale('en_us')); // "en-US"
console.log(gt.standardizeLocale('zh_cn')); // "zh-CN"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

// I locale già standardizzati vengono lasciati invariati
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"

Note

• Converte gli underscore in trattini e normalizza le maiuscole/minuscole
• Restituisce una stringa vuota per i codici di locale non validi
• I codici lingua diventano minuscoli, i codici di regione diventano maiuscoli
• Preserva le estensioni e le varianti del locale quando presenti

Prossimi passaggi

• Verifica le impostazioni locali standardizzate con isValidLocale
• Risolvi le impostazioni locali canoniche con resolveCanonicalLocale
• Ottieni le proprietà dell'impostazione locale con getLocaleProperties