Temporal.PlainTime.prototype.toString()

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

toString() 方法用於 Temporal.PlainTime 例項,以 RFC 9557 格式 返回表示該時間的字串。

語法

js
toString()
toString(options)

引數

options 可選

一個包含以下部分或全部屬性的物件(按檢索和驗證的順序):

fractionalSecondDigits 可選

一個 0 到 9 之間的整數,或字串 "auto"。預設值為 "auto"。如果為 "auto",則從小數秒中刪除尾隨零。否則,秒元件的小數部分包含這麼多位數,必要時用零填充或四捨五入。

roundingMode 可選

一個字串,指定如何對超出 fractionalSecondDigits 的小數秒位數進行四捨五入。請參閱 Intl.NumberFormat()。預設為 "trunc"

smallestUnit 可選

一個字串,指定輸出中包含的最小單位。可能的值是 "minute""second""millisecond""microsecond""nanosecond",或它們的複數形式,它們(除了 "minute")分別等同於 fractionalSecondDigits 值為 0369。如果指定,則忽略 fractionalSecondDigits

返回值

RFC 9557 格式 表示該時間的字串。

異常

RangeError

如果任何選項無效,則丟擲。

TypeError

如果 options 不是物件或 undefined,則丟擲錯誤。

示例

使用 toString()

js
const time = Temporal.PlainTime.from("12:34:56");
console.log(time.toString()); // '12:34:56'

使用選項

js
const time1 = Temporal.PlainTime.from("12:00:00");
console.log(time1.toString()); // '12:00:00'
console.log(time1.toString({ fractionalSecondDigits: 1 })); // '12:00:00.0'
console.log(time1.toString({ smallestUnit: "minute" })); // '12:00'
console.log(time1.toString({ smallestUnit: "nanosecond" })); // '12:00:00.000000000'

const time2 = Temporal.PlainTime.from("12:34:56.123456789");
console.log(time2.toString({ fractionalSecondDigits: 4 })); // '12:34:56.1234'
console.log(
  time2.toString({ fractionalSecondDigits: 4, roundingMode: "halfExpand" }),
); // '12:34:56.1235'

規範

規範
Temporal
# sec-temporal.plaintime.prototype.tostring

瀏覽器相容性

另見