Utility FunctionsLocales

standardizeLocale

Référence de l’API de la fonction standardizeLocale

Vue d’ensemble

La fonction standardizeLocale standardise un code de locale BCP‑47 afin d’assurer un formatage et une casse corrects, sans nécessiter d’instance de la GT class.

import { standardizeLocale } from 'generaltranslation';

// Corriger les problèmes de formatage courants
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'

// Les locales déjà standardisées sont conservées telles quelles
console.log(standardizeLocale('es-ES')); // 'es-ES'

Références

Paramètres

Prop

Type

Renvoie

string - Code de locale BCP‑47 normalisé ou chaîne vide si invalide


Exemples

Traitement des entrées utilisateur

import { standardizeLocale, isValidLocale } from 'generaltranslation';

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

// Tester différentes entrées
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
  console.log(processUserInput(input));
});

Notes

  • Convertit les underscores en tirets
  • Normalise la casse (langue en minuscules, région en majuscules)
  • Renvoie une chaîne vide pour les formats non valides
  • Essentiel pour normaliser l’entrée locale provenant de diverses sources
  • Aucune dépendance externe — simple manipulation de chaînes

Prochaines étapes

Comment trouvez-vous ce guide ?