Temporal.PlainTime.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 thực thể Temporal.PlainTime trả về một đối tượng Temporal.Duration mới đại diện cho khoảng thời gian từ thời điểm này đến một thời điểm khác (dưới dạng có thể chuyển đổi bởi Temporal.PlainTime.from()). Khoảng thời gian là dương nếu thời điểm kia đứng sau thời điểm này, và âm nếu đứng trước.
Phương thức này thực hiện phép tính 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, một đối tượng, hoặc một thực thể
Temporal.PlainTimeđại diện cho thời điểm cần trừ thời điểm này. Nó được chuyển đổi thành đối tượngTemporal.PlainTimebằng cùng thuật toán nhưTemporal.PlainTime.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ừ thời điểm này cho đến other. Khoảng thời gian là dương nếu other đứng sau thời điểm này, và âm nếu đứng trước.
Ngoại lệ
RangeError-
Ném ra nếu bất kỳ tùy chọn nào không hợp lệ.
Ví dụ
Sử dụng until()
const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.until(lunchTime);
console.log(`It will be ${duration.toLocaleString("en-US")} until lunch`);
// Ví dụ đầu ra: "It will be 3 hr, 42 min, 21 sec, 343 ms, 131 μs, 718 ns until lunch"
Để xem thêm ví dụ, hãy xem since().
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.until |