Temporal.PlainTime.prototype.toString()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức toString() của các thực thể Temporal.PlainTime trả về một chuỗi đại diện cho thời gian này theo định dạng RFC 9557.

Cú pháp

js
toString()
toString(options)

Tham số

options Optional

Một đối tượng chứa một số hoặc tất cả các thuộc tính sau (theo thứ tự chúng được truy xuất và xác thực):

fractionalSecondDigits Optional

Một số nguyên từ 0 đến 9, hoặc chuỗi "auto". Mặc định là "auto". Nếu là "auto", các số 0 theo sau trong phần giây thập phân sẽ bị loại bỏ. Nếu không, phần thập phân của thành phần giây chứa số chữ số này, được đệm bằng số 0 hoặc làm tròn nếu cần.

roundingMode Optional

Một chuỗi chỉ định cách làm tròn các chữ số giây thập phân vượt quá fractionalSecondDigits. Xem Intl.NumberFormat(). Mặc định là "trunc".

smallestUnit Optional

Một chuỗi chỉ định đơn vị nhỏ nhất để đưa vào đầu ra. Các giá trị có thể là "minute", "second", "millisecond", "microsecond", và "nanosecond", hoặc dạng số nhiều của chúng, tương đương (ngoại trừ "minute") với các giá trị fractionalSecondDigits lần lượt là 0, 3, 6, 9. Nếu được chỉ định, fractionalSecondDigits sẽ bị bỏ qua.

Giá trị trả về

Một chuỗi theo định dạng RFC 9557 đại diện cho thời gian này.

Ngoại lệ

RangeError

Ném ra nếu bất kỳ tùy chọn nào không hợp lệ.

TypeError

Ném ra nếu options không phải là đối tượng hoặc undefined.

Ví dụ

Sử dụng toString()

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

Sử dụng các tùy chọn

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'

Đặc tả

Specification
Temporal
# sec-temporal.plaintime.prototype.tostring

Tương thích trình duyệt

Xem thêm