Aperçu

La méthode standardizeLocale standardise un code de locale BCP-47 afin de garantir un formatage et une casse corrects. Elle convertit les codes de locale dans leur format canonique, les rendant adaptés à l’utilisation avec les API d’internationalisation et assurant la cohérence dans l’ensemble de votre application.

Références

Paramètres

Description des paramètres

Renvoie

string - Le code de locale BCP-47 normalisé, ou une chaîne vide si l’entrée est invalide

Lève

• Error - Si aucune locale n’est fournie et que l’instance n’a pas de targetLocale configurée

Comportement

Corrections de format courantes appliquées :

• en_US → en-US (trait de soulignement remplacé par un tiret)
• zh_cn → zh-CN (trait de soulignement remplacé par un tiret, casse)
• EN-gb → en-GB (langue en minuscules, région en majuscules)
• Fr-ca → fr-CA (casse correcte partout)
• ja_jp → ja-JP (trait de soulignement et casse)

Exemples

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

// Standardiser différents formats de locales
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"

// Les locales déjà standardisées ne sont pas modifiées
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"

Notes

• Convertit les underscores en tirets et normalise la casse
• Renvoie une chaîne vide pour les codes de locale invalides
• Les codes de langue passent en minuscules, les codes de région en majuscules
• Préserve les extensions et variantes de locale lorsqu’elles sont présentes

Prochaines étapes

• Validez les locales standardisées avec isValidLocale
• Résolvez les locales canoniques avec resolveCanonicalLocale
• Récupérez les propriétés de la locale avec getLocaleProperties