Intl.ListFormat() コンストラクター

The Intl.ListFormat() コンストラクターは、言語に応じたリストの書式化を可能にするオブジェクトを生成します。

構文

new Intl.ListFormat([locales[, options]])

引数

locales 省略可

BCP47 言語タグの文字列、または、そのような文字列の配列です。locales 引数の一般的な形式と解釈は、 Intl のページをご覧ください。

options 省略可

以下のプロパティの一部またはすべてを持つオブジェクトです。

localeMatcher
使用するロケール一致アルゴリズム。利用可能な値は lookupbest fit です。既定値は best fit です。このオプションについての詳細は、 Intl のページをご覧ください。
type
出力メッセージの書式です。可能な値は "and" ベースのリストを表す conjunction (既定値、例えば A, B, and C)、または "or" ベースのリストを表す disjunction (例えば A, B, or C)、単位付きの値のリストを表す unit (例えば 5 pounds, 12 ounces) です。
style
書式化されたメッセージの長さです。利用可能な値は、 long (既定値、例えば A, B, and C)、 short (例えば A, B, C)、 narrow (例えば A B C) です。 styleshort または narrow であった場合、 type オプションには unit のみが許可されます。

format の使用

次の例では、英語を使用するリストのフォーマッターを生成する方法を示します。

const list = ['Motorcycle', 'Bus', 'Car'];

 console.log(new Intl.ListFormat('en-GB', { style: 'long', type: 'conjunction' }).format(list));
// > Motorcycle, Bus and Car

 console.log(new Intl.ListFormat('en-GB', { style: 'short', type: 'disjunction' }).format(list));
// > Motorcycle, Bus or Car

 console.log(new Intl.ListFormat('en-GB', { style: 'narrow', type: 'unit' }).format(list));
// > Motorcycle Bus Car

仕様書

仕様書
Intl.ListFormat
ListFormat() の定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報