Übersicht

Die Methode standardizeLocale vereinheitlicht einen BCP‑47‑Locale-Code, um korrektes Format und die richtige Groß- und Kleinschreibung sicherzustellen. Sie wandelt Locale-Codes in ihr kanonisches Standardformat um, macht sie für die Verwendung mit Internationalisierungs-APIs geeignet und stellt Konsistenz in Ihrer Anwendung sicher.

Referenzen

Parameter

Parameterbeschreibung

Rückgabe

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

Wirft

• Error – Wenn keine locale angegeben ist und für die Instanz keine targetLocale konfiguriert ist

Verhalten

Häufige Formatkorrekturen:

• en_US → en-US (Unterstrich zu Bindestrich)
• zh_cn → zh-CN (Unterstrich zu Bindestrich, Groß-/Kleinschreibung)
• EN-gb → en-GB (Sprache kleingeschrieben, Region großgeschrieben)
• Fr-ca → fr-CA (korrekte Groß-/Kleinschreibung)
• 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 Locales bleiben unverändert
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 Schreibweise
• Gibt für ungültige locale codes einen leeren String zurück
• Sprachcodes werden kleingeschrieben, Regionscodes großgeschrieben
• Erhält locale-Erweiterungen und -Varianten, wenn vorhanden

Nächste Schritte

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