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));
});

Заметки

  • Преобразует символы подчёркивания в дефисы
  • Нормализует регистр (язык — строчные, регион — прописные)
  • Возвращает пустую строку для некорректных форматов
  • Необходимо для нормализации ввода локалей из разных источников
  • Без внешних зависимостей — чистая работа со строками

Дальнейшие шаги

Насколько полезно это руководство?

standardizeLocale