ダッシュボード
Utility FunctionsLocales

standardizeLocale

standardizeLocale 関数のAPIリファレンス

概要

standardizeLocale 関数は、GT クラスのインスタンスなしで、BCP-47 のロケールコードを正しい形式と大文字・小文字の扱いに統一します。

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

注意事項

  • アンダースコアをハイフンに変換
  • 大文字／小文字を正規化（言語は小文字、地域は大文字）
  • 無効な形式の場合は空文字列を返す
  • さまざまなソースからの locale 入力を正規化するうえで不可欠
  • 外部依存なし — 純粋な文字列操作

次のステップ

このガイドはどうでしたか？

resolveAliasLocale

resolveAliasLocale 関数のAPIリファレンス

CustomMapping

カスタムのロケールコードマッピングおよび拡張ロケールメタデータの型定義

このページについて

概要
リファレンス
パラメータ
戻り値
例
ユーザー入力の処理
注意事項
次のステップ
standardizeLocale