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

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

試してみましょう

構文

js
new Intl.ListFormat();
new Intl.ListFormat(locales);
new Intl.ListFormat(locales, options);

引数

locales 省略可

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

options 省略可

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

localeMatcher

使用するロケール照合アルゴリズム。取りうる値は以下の通りです。

  • "best fit" （既定値）
  • "lookup" このオプションについての詳細は、 Intl のページをご覧ください。
type

グループ化の種類を示します。取りうる値は以下の通りです。

  • "conjunction" - リスト項目の "and" ベースのグループ化: "A, B, and C" （既定値）
  • "disjunction" - リスト項目の "or" ベースのグループ化: "A, B, or C"
  • "unit" - リスト項目の単位としてのグループ化（"and" ベースでも "or" ベースでもない）: "A, B, C"
style

グループ化のスタイルを示します（例えば、リストの区切り文字や結合などが含まれます）。取りうる値は以下の通りです。

  • "long": "A, B, and C" （既定値）
  • "short": "A, B, C"
  • "narrow": "A B C"

例

format の使用

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

js
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: "long" }).format(list));
// Motorcycle, Bus and Car

console.log(new Intl.ListFormat("en-US", { style: "long" }).format(list));
// Motorcycle, Bus, and Car

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

console.log(
  new Intl.ListFormat("en-US", { style: "short", type: "conjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus, & Car

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

console.log(
  new Intl.ListFormat("en-GB", { style: "long", type: "disjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus or 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: "disjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus or Car

console.log(new Intl.ListFormat("en-US", { style: "narrow" }).format(list));
// Motorcycle, Bus, Car

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

console.log(
  new Intl.ListFormat("en-US", { style: "long" }).format([
    "30 degrees",
    "15 minutes",
    "50 seconds",
  ]),
);
// 30 degrees, 15 minutes, and 50 seconds

console.log(
  new Intl.ListFormat("en-US", { style: "narrow" }).format([
    "30 degrees",
    "15 minutes",
    "50 seconds",
  ]),
);
// 30 degrees, 15 minutes, 50 seconds

console.log(
  new Intl.ListFormat("en-US", { style: "narrow", type: "unit" }).format([
    "30°",
    "15′",
    "50″",
  ]),
);
// 30° 15′ 50″

仕様書

Specification
ECMAScript Internationalization API Specification
# sec-intl-listformat-constructor

ブラウザーの互換性

BCD tables only load in the browser

関連情報