JavaScript | Intl.DateTimeFormat.prototype.formatRangeToParts() 方法

在 JavaScript 中， Intl.DateTimeFormat.prototype.formatRangeToParts() 是一个方法，它接受两个日期参数并返回一组格式化的日期范围部分。这个方法适用于国际化和本地化的需求，可以根据特定的语言配置日期格式。 formatRangeToParts() 方法在ES2018（ECMAScript 2018）中引入，是 Intl.DateTimeFormat() 方法的扩展。

语法

以下是 Intl.DateTimeFormat.prototype.formatRangeToParts() 方法的语法：

dateFormatter.formatRangeToParts(startDate, endDate)

参数

• startDate：要格式化的日期范围的开始日期（必需）
• endDate：要格式化的日期范围的结束日期（必需）

返回值

• Array：格式化的日期范围部件数组。

例子

下面是 Intl.DateTimeFormat.prototype.formatRangeToParts() 方法的一个例子：

const dateFormatter = new Intl.DateTimeFormat('en-US', { weekday: 'short', year: 'numeric', month: 'short', day: 'numeric' });

const startDate = new Date('2022-10-10');
const endDate = new Date('2022-10-15');

const formattedDateRange = dateFormatter.formatRangeToParts(startDate, endDate);

console.log(formattedDateRange);

运行此代码，将得到以下输出：

[ { type: 'weekday', value: 'Mon' },
  { type: 'literal', value: ', ' },
  { type: 'month', value: 'Oct' },
  { type: 'literal', value: ' ' },
  { type: 'day', value: '10' },
  { type: 'literal', value: ' – ' },
  { type: 'weekday', value: 'Sat' },
  { type: 'literal', value: ', ' },
  { type: 'month', value: 'Oct' },
  { type: 'literal', value: ' ' },
  { type: 'day', value: '15' },
  { type: 'literal', value: ', ' },
  { type: 'year', value: '2022' } ]

以上代码创建了一个 Intl.DateTimeFormat() 实例，将其传递给 formatRangeToParts() 方法，然后将其传递给 startDate 和 endDate 参数。 formattedDateRange 变量将接收此方法的返回值，包含表示日期范围的部分的数组。

在这个例子中，我们可以看到 formattedDateRange 数组包含了每个日期的部分，由类型和值构成（例如，‘weekday’类型表示“星期几”，‘month’类型表示“月份”等）。