Utility FunctionsLocales
standardizeLocale
Справочник API по функции standardizeLocale
Обзор
Функция standardizeLocale приводит код локали BCP‑47 к стандартному формату и регистру, не требуя создания экземпляра класса GT.
import { standardizeLocale } from 'generaltranslation';
// Исправление типичных ошибок форматирования
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'
// Уже стандартизированные локали остаются без изменений
console.log(standardizeLocale('es-ES')); // 'es-ES'Справочные материалы
Параметры
Prop
Type
Возвращает
string — стандартизированный код локали BCP‑47 или пустую строку, если код недействителен
Примеры
Обработка ввода пользователя
import { standardizeLocale, isValidLocale } from 'generaltranslation';
function processUserInput(input: string) {
const standardized = standardizeLocale(input.trim());
const isValid = isValidLocale(standardized);
return {
original: input,
standardized,
isValid
};
}
// Тестируем различные варианты ввода
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
console.log(processUserInput(input));
});Заметки
- Преобразует символы подчёркивания в дефисы
- Нормализует регистр (язык — строчные, регион — прописные)
- Возвращает пустую строку для некорректных форматов
- Необходимо для нормализации ввода локалей из разных источников
- Без внешних зависимостей — чистая работа со строками
Дальнейшие шаги
- Используйте метод класса GT
standardizeLocale - Проверьте с помощью
isValidLocale
Насколько полезно это руководство?