Temporal.Duration.prototype.subtract()

Limited availability

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

Phương thức subtract() của các instance Temporal.Duration trả về một đối tượng Temporal.Duration mới với hiệu của duration này và một duration đã cho. Nó tương đương với việc cộng giá trị phủ định của duration kia.

Cú pháp

js
subtract(other)

Tham số

other

Một chuỗi, một đối tượng, hoặc một instance Temporal.Duration đại diện cho duration cần trừ khỏi duration này. Nó được chuyển đổi thành đối tượng Temporal.Duration bằng thuật toán giống như Temporal.Duration.from().

Giá trị trả về

Một đối tượng Temporal.Duration mới đại diện cho hiệu của duration này và other.

Ngoại lệ

RangeError

Được ném ra trong một trong các trường hợp sau:

  • this hoặc othercalendar duration (có years, months hoặc weeks khác không), vì calendar duration là mơ hồ mà không có lịch và tham chiếu thời gian.
  • Hiệu của thisother vượt quá hoặc dưới mức duration tối đa hoặc tối thiểu có thể biểu diễn, là ±253 giây.

Ví dụ

Sử dụng subtract()

js
const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -20 });

const d3 = d1.subtract(d2);
console.log(d3.toString()); // "PT2H50M"

Để biết thêm ví dụ và lưu ý, xem phương thức add().

Đặc tả

Specification
Temporal
# sec-temporal.duration.prototype.subtract

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

Xem thêm