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值為0、3、6、9。如果指定,則忽略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 |
瀏覽器相容性
載入中…