Intl.ListFormat

概要

Intl.ListFormat はリストの各要素をロケールに応じた接続詞やカンマで結合した文字列を生成します。

対応ブラウザ

機能	デスクトップ				モバイル
機能	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`javascript.builtins.Intl.ListFormat`	72	79	78	14.1	72	14.5
ビルトインオブジェクト
`Intl.ListFormat.ListFormat` Intl.ListFormat() コンストラクターは、言語を考慮したリストの書式化を可能にする Intl/ListFormat オブジェクトを生成します。	72	79	78	14.1	72	14.5
`Intl.ListFormat.format` format() メソッドは、リストの言語固有の表現を文字列で返します。	72	79	78	14.1	72	14.5
`Intl.ListFormat.formatToParts` Intl.ListFormat.prototype.formatToParts() メソッドは、ロケールを考慮した値のリストの書式化で使用できる様々な部分を表すオブジェクトの配列 (Array) を返します。	72	79	78	14.1	72	14.5
`Intl.ListFormat.resolvedOptions` Intl.ListFormat.prototype.resolvedOptions() メソッドは、現在の Intl.ListFormat オブジェクトの構築時に計算されたロケールとスタイル整形オプションを反映したプロパティを持つ新しいオブジェクトを返します。	72	79	78	14.1	72	14.5
`Intl.ListFormat.supportedLocalesOf` Intl.ListFormat.supportedLocalesOf() メソッドは、指定したロケールのうち、ランタイムの既定のロケールに代替する必要なくリストの書式化に対応しているロケールを含む配列を返します。	72	79	78	14.1	72	14.5

1+対応 (バージョン) 未対応 ※注釈ありサブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT

new Intl.ListFormat('ja', { type: 'conjunction' })
  .format(['apple', 'banana', 'orange']);
// 'apple, banana, and orange'

new Intl.ListFormat('en', { type: 'conjunction' })
  .format(['Apple', 'Banana', 'Orange']);
// 'Apple, Banana, and Orange'