Übersicht

Die Methode standardizeLocale normalisiert einen BCP‑47‑locale code, um korrektes Format und die richtige Groß‑/Kleinschreibung sicherzustellen. Sie wandelt locale codes in ihr kanonisches Format um, macht sie damit für Internationalisierungs‑APIs geeignet und sorgt für Konsistenz in der gesamten Anwendung.

Referenzen

Parameter

Parameterbeschreibung

Rückgabewert

string - Der standardisierte BCP‑47-Locale-Code oder ein leerer String, wenn die Eingabe ungültig ist

Löst aus

• Error – Wenn keine locale übergeben wird und für die Instanz kein targetLocale konfiguriert ist

Verhalten

Häufig angewendete Formatkorrekturen:

• en_US → en-US (Unterstrich zu Bindestrich)
• zh_cn → zh-CN (Unterstrich zu Bindestrich, Groß-/Kleinschreibung)
• EN-gb → en-GB (Sprache klein, Region groß)
• Fr-ca → fr-CA (korrekte Groß-/Kleinschreibung durchgängig)
• ja_jp → ja-JP (Unterstrich und Groß-/Kleinschreibung)

Beispiele

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

// Verschiedene Locale-Formate standardisieren
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"

// Bereits standardisierte Locale-Werte werden unverändert übernommen
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"

Hinweise

• Wandelt Unterstriche in Bindestriche um und normalisiert die Groß-/Kleinschreibung
• Gibt bei ungültigen Locale-Codes einen leeren String zurück
• Sprachcodes werden klein-, Regionscodes großgeschrieben
• Erhält Locale-Erweiterungen und -Varianten, sofern vorhanden

Nächste Schritte

• Standardisierte locales mit isValidLocale validieren
• Kanonische locales mit resolveCanonicalLocale ermitteln
• locale-Eigenschaften mit getLocaleProperties abrufen