Temporal.Duration.prototype.toString()

Cú pháp

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 ở cuối sẽ bị xóa khỏi phần thập phân của giây. Ngược lại, 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 khi 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 cần đưa vào đầu ra. Các giá trị có thể là "second", "millisecond", "microsecond", và "nanosecond", hoặc dạng số nhiều của chúng, tương đương với các giá trị fractionalSecondDigits là 0, 3, 6, 9 tương ứng. Nếu được chỉ định, fractionalSecondDigits sẽ bị bỏ qua.

Giá trị trả về

Một chuỗi biểu diễn duration đã cho theo định dạng ISO 8601, với các thành phần dưới giây được định dạng theo các tùy chọn. Duration bằng không được biểu diễn là "PT0S".

Ngoại lệ

RangeError

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

Ví dụ

Sử dụng toString()

const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
console.log(duration.toString()); // 'PT1H30M15S'

// Chuyển thành chuỗi ngầm định gọi toString()
console.log(`${duration}`); // 'PT1H30M15S'

Sử dụng options

const worldRecord = Temporal.Duration.from({ seconds: 9, milliseconds: 580 });
console.log(worldRecord.toString()); // 'PT9.58S'
console.log(worldRecord.toString({ fractionalSecondDigits: 1 })); // 'PT9.5S'
console.log(worldRecord.toString({ fractionalSecondDigits: 0 })); // 'PT9S'
console.log(worldRecord.toString({ smallestUnit: "millisecond" })); // 'PT9.580S'
console.log(
  worldRecord.toString({
    fractionalSecondDigits: 1,
    roundingMode: "halfExpand",
  }),
); // 'PT9.6S'

Đặc tả

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

Xem thêm

• Temporal.Duration
• Temporal.Duration.prototype.toJSON()
• Temporal.Duration.prototype.toLocaleString()