Intl.RelativeTimeFormat.prototype.formatToParts()

¥Syntax

formatToParts(value, unit)

¥Parameters

value

在国际化相对时间消息中使用的数值。

unit

国际化消息中相对时间使用的单位。可能的值为："year", "quarter", "month", "week", "day", "hour", "minute", "second".复数形式也是允许的。

¥Return value

包含格式化相对时间部分的 Array 个对象。

¥An Array of objects containing the formatted relative time in parts.

¥Description

Intl.RelativeTimeFormat.prototype.formatToParts 方法是 format 方法的一个版本，它返回表示对象的 "parts" 的对象数组，将格式化数字分成其组成部分并将其与其他周围文本分开。这些对象有两个属性：输入 NumberFormat formatToParts 类型和值，该值是作为输出组件的字符串。如果 "part" 来自 NumberFormat，它将有一个单位属性，指示正在格式化的单位；作为较大框架一部分的文字不具有此属性。

¥The Intl.RelativeTimeFormat.prototype.formatToParts method is a version of the format method which it returns an array of objects which represent "parts" of the object, separating the formatted number into its constituent parts and separating it from other surrounding text. These objects have two properties: type a NumberFormat formatToParts type, and value, which is the String which is the component of the output. If a "part" came from NumberFormat, it will have a unit property which indicates the unit being formatted; literals which are part of the larger frame will not have this property.

¥Examples

¥Using formatToParts

const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });

// Format relative time using the day unit
rtf.formatToParts(-1, "day");
// [{ type: "literal", value: "yesterday"}]

rtf.formatToParts(100, "day");
// [
//   { type: "literal", value: "in " },
//   { type: "integer", value: "100", unit: "day" },
//   { type: "literal", value: " days" }
// ]

¥See also

• Intl.RelativeTimeFormat