Temporal.PlainDate.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.PlainDate trả về một đối tượng Temporal.PlainDate mới biểu diễn ngày này được lùi lại theo một khoảng thời gian nhất định (ở dạng có thể chuyển đổi bởi Temporal.Duration.from()).

Nếu bạn muốn trừ hai ngày và lấy khoảng thời gian, hãy sử dụng since() hoặc until() thay thế.

Cú pháp

subtract(duration)
subtract(duration, options)

Tham số

duration

Một chuỗi, đối tượng, hoặc instance Temporal.Duration biểu diễn khoảng thời gian cần trừ từ ngày này. Nó được chuyển đổi thành đối tượng Temporal.Duration bằng cùng thuật toán như Temporal.Duration.from().

options Optional

Một đối tượng chứa thuộc tính sau:

overflow Optional

Một chuỗi chỉ định hành vi khi thành phần ngày nằm ngoài phạm vi. Các giá trị có thể là:

"constrain" (mặc định): Thành phần ngày được kẹp vào phạm vi hợp lệ.
"reject": RangeError được ném ra nếu thành phần ngày nằm ngoài phạm vi.

RangeError: Được ném ra nếu kết quả không nằm trong phạm vi có thể biểu diễn, là ±(10⁸ + 1) ngày, tức khoảng ±273.972,6 năm, từ Unix epoch.

Ví dụ

Trừ một khoảng thời gian

const start = Temporal.PlainDate.from("2022-01-01");
const end = start.subtract({ years: 1, months: 2, weeks: 3, days: 4 });
console.log(end.toString()); // 2020-10-07

Xem thêm các ví dụ trong add().