Temporal.PlainDate.prototype.until()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức until() của các instance Temporal.PlainDate trả về một đối tượng Temporal.Duration mới đại diện cho khoảng thời gian từ ngày này đến một ngày khác (ở dạng có thể chuyển đổi bởi Temporal.PlainDate.from()). Khoảng thời gian là dương nếu ngày kia ở sau ngày này, và âm nếu ở trước.
Phương thức này thực hiện other - this. Để thực hiện this - other, hãy dùng phương thức since().
Cú pháp
until(other)
until(other, options)
Tham số
other-
Một chuỗi, đối tượng, hoặc instance
Temporal.PlainDateđại diện cho ngày để trừ ngày này từ đó. Nó được chuyển đổi thành đối tượngTemporal.PlainDatebằng cùng thuật toán nhưTemporal.PlainDate.from(). Phải có cùng lịch vớithis. optionsOptional-
Các tùy chọn giống như
since().
Giá trị trả về
Một đối tượng Temporal.Duration mới đại diện cho khoảng thời gian từ ngày này đến other. Khoảng thời gian là dương nếu other ở sau ngày này, và âm nếu ở trước.
Ngoại lệ
RangeError-
Ném ra trong một trong các trường hợp sau:
othercó lịch khác vớithis.- Bất kỳ tùy chọn nào không hợp lệ.
Ví dụ
Sử dụng until()
const launch = Temporal.PlainDate.from("2035-01-01");
const now = Temporal.Now.plainDateISO();
const duration = now.until(launch);
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);
Xem thêm ví dụ tại since().
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.until |