Temporal.PlainYearMonth.prototype.subtract()

Cú pháp

subtract(duration)
subtract(duration, options)

Tham số

duration

Một chuỗi, một đối tượng, hoặc một thực thể Temporal.Duration đại diện cho khoảng thời gian cần trừ khỏi năm-tháng 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 một 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"

Một RangeError được ném ra nếu thành phần ngày nằm ngoài phạm vi.

Giá trị trả về

Một đối tượng Temporal.PlainYearMonth mới đại diện cho năm-tháng được chỉ định bởi PlainYearMonth gốc, trừ đi khoảng thời gian.

Ngoại lệ

RangeError

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

Mô tả

Trừ một khoảng thời gian tương đương với cộng phủ định của nó, do đó tất cả các cân nhắc tương tự đều áp dụng. Trừ một khoảng thời gian dương bắt đầu từ cuối năm-tháng và dịch chuyển về phía trước, vì vậy bất kỳ đơn vị nào nhỏ hơn độ dài của tháng đều bị bỏ qua.

Ví dụ

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

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

Để xem thêm ví dụ, hãy xem add().

Đặc tả

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

Xem thêm

• Temporal.PlainYearMonth
• Temporal.Duration
• Temporal.PlainYearMonth.prototype.add()
• Temporal.PlainYearMonth.prototype.since()
• Temporal.PlainYearMonth.prototype.until()