Utility FunctionsLocales

standardizeLocale

standardizeLocale 函数的 API 参考

概览

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'

// 已标准化的 locale 直接通过
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));
});

说明

  • 将下划线转换为连字符
  • 规范化大小写(语言小写,地区大写)
  • 对无效格式返回空字符串
  • 用于规范化来自各类来源的 locale 输入
  • 无外部依赖——纯字符串处理

后续步骤

这份指南怎么样?

standardizeLocale