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ượngTemporal.Durationbằ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:
thishoặcotherlà calendar duration (cóyears,monthshoặcweekskhá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
thisvàothervượ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> |