JavaScriptにおける言語コード指定の詳解

この記事では言語コードを指定する引数のことを、便箋上locales引数とします。

locales引数の使い所

new Intl.DateTimeFormat([locales[, options]]).format(dateObj);
new Intl.NumberFormat([locales[, options]]).format(dateObj);
dateObj.toLocaleString([locales[, options]]);

書き方

BCP47に基づいた言語を表す文字列、またはその配列での指定です。

上のリストだけでは足らない場合は、Webで使う主な言語コードの一覧(BCP47準拠) | listfulをご覧下さい。

何も指定しないか明示的にundefinedを指定した場合は、実装によりますがOSのデフォルト言語(Firefoxはそのブラウザのデフォルト言語)に元づいて処理されます。

言語コードのUnicode拡張

言語コードでは、jaなどに加えて、uという拡張部分タグを後ろに付けることができます。そしてuタグに続けて、下のような指定ができます。

u-nu-何か

Intl.NumberFormatとIntl.DateTimeFormatで使います。普通は0~9となる番号表記(numbering system)を変えることができます。

有効な全ての指定値は、言語コードで数字の表し方を指定する | listfulをご覧下さい。

u-ca-何か

Intl.DateTimeFormatでのみ使える、紀年法(calendar)の指定です。

dateObj = new Date(2020, 11, 3, 4, 56, 7, 890);
new Intl.DateTimeFormat('ja-u-ca-japanese', {dateStyle: 'full', timeStyle: 'full'}).format(dateObj);
// 出力 'R2/12/03 04:56'

u-hc-何か

Intl.DateTimeFormatでのみ使える、時制(hour cycle)の指定です。

u-co-何か

Intl.Collatorでのみ使える、比較ルール(collation)の指定です。

u-kn-何か

Intl.Collatorでのみ使える、数値(numeric)として比較するかの指定です。

数字の比較では、文字列として扱うか数値として扱うかで、順番が変わってしまうことがあります。

new Intl.Collator('ja-u-kn-true').compare('2', '10'); // 出力: (負の数)
new Intl.Collator('ja-u-kn-false').compare('2', '10'); // 出力: (正の数)
new Intl.Collator('ja').compare('2', '10'); // 出力: (正の数)

なお数字以外の番号は数字として扱ってくれないようです。

new Intl.Collator('zh-Hans-u-nu-hanidec-kn-true').compare('二', '一〇');
new Intl.Collator('zh-Hans-u-nu-hanidec-kn-false').compare('二', '一〇');
new Intl.Collator('zh-Hans-u-nu-hanidec').compare('二', '一〇');
// いずれも出力は負の数

u-kf-何か

ラテン文字などにおいて、大文字小文字の順序(caseFirst)を指定します。

new Intl.Collator('ja-u-kf-upper').compare('R', 'r'); // 出力: (負の数)
new Intl.Collator('ja-u-kf-lower').compare('R', 'r'); // 出力: (正の数)
new Intl.Collator('ja-u-kf-false').compare('R', 'r'); // 出力: (正の数)

参考リンク

• Intl - JavaScript | MDN
• Intl.Locale.prototype.numberingSystem - JavaScript | MDN
• Intl.Locale.prototype.calendar - JavaScript | MDN
• Intl.Locale.prototype.collation - JavaScript | MDN
• ISO 15924 - Wikipedia
• 言語タグ - HTML5