Intl.DateTimeFormat.prototype.formatRangeToParts()

基线 广泛可用

此功能已建立良好，并且在许多设备和浏览器版本上均能正常运行。它自以下时间起在所有浏览器中均可用 2017 年 9 月.

formatRangeToParts() 方法是 Intl.DateTimeFormat 实例的方法，它返回一个包含特定于区域设置的标记的数组，表示由该 Intl.DateTimeFormat 对象生成的格式化日期范围的每个部分。

试一试

语法

js
formatRangeToParts(startDate, endDate)

示例

基本 formatRangeToParts 用法

此方法接收两个 Date 并返回一个 Array，该数组包含对象，这些对象包含表示格式化日期范围的每个部分的特定于区域设置的标记。

注意： 在您的区域设置中显示的返回值可能与下面列出的返回值不同。

js
const date1 = new Date(Date.UTC(1906, 0, 10, 10, 0, 0)); // Wed, 10 Jan 1906 10:00:00 GMT
const date2 = new Date(Date.UTC(1906, 0, 10, 11, 0, 0)); // Wed, 10 Jan 1906 11:00:00 GMT

const fmt = new Intl.DateTimeFormat("en", {
  hour: "numeric",
  minute: "numeric",
});

console.log(fmt.formatRange(date1, date2)); // '10:00 – 11:00 AM'

fmt.formatRangeToParts(date1, date2);
// [
//   { type: 'hour',      value: '10',  source: "startRange" },
//   { type: 'literal',   value: ':',   source: "startRange" },
//   { type: 'minute',    value: '00',  source: "startRange" },
//   { type: 'literal',   value: ' – ', source: "shared"     },
//   { type: 'hour',      value: '11',  source: "endRange"   },
//   { type: 'literal',   value: ':',   source: "endRange"   },
//   { type: 'minute',    value: '00',  source: "endRange"   },
//   { type: 'literal',   value: ' ',   source: "shared"     },
//   { type: 'dayPeriod', value: 'AM',  source: "shared"     }
// ]

规范

规范
ECMAScript 国际化 API 规范
# sec-Intl.DateTimeFormat.prototype.formatRangeToParts

浏览器兼容性

BCD 表格仅在浏览器中加载

参见