Temporal.PlainYearMonth.prototype.until()

Cú pháp

until(other)
until(other, options)

Tham số

other

Một chuỗi, một đối tượng, hoặc một instance Temporal.PlainYearMonth biểu diễn năm-tháng cần lấy năm-tháng này trừ đi. Nó được chuyển đổi thành đối tượng Temporal.PlainYearMonth bằng cùng thuật toán như Temporal.PlainYearMonth.from(). Nó phải có cùng calendar với this.

options Optional

Các tùy chọn giống như since().

Giá trị trả về

Một đối tượng Temporal.Duration mới biểu diễn khoảng thời gian từ năm-tháng này cho đến other. Khoảng thời gian là dương nếu other đến sau năm-tháng này, và âm nếu đến trước.

Ngoại lệ

RangeError

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

• other có calendar khác với this.
• Bất kỳ tùy chọn nào không hợp lệ.

Ví dụ

Sử dụng until()

const launch = Temporal.PlainYearMonth.from("2035-01");
const now = Temporal.Now.plainDateISO().toPlainYearMonth();
const duration = now.until(launch);
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);

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

Đặc tả kỹ thuật

Khả năng tương thích với trình duyệt

Xem thêm

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