Temporal.PlainTime.prototype.since()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức since() 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ừ một thời điểm khác (dưới dạng có thể chuyển đổi bởi Temporal.PlainTime.from()) đến thời điểm này. Khoảng thời gian là dương nếu thời điểm kia đứng trước thời điểm này, và âm nếu đứng sau.
Phương thức này thực hiện phép tính this - other. Để thực hiện other - this, hãy dùng phương thức until().
Cú pháp
since(other)
since(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ừ khỏi 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(). optionsOptional-
Một đối tượng chứa các tùy chọn cho
Temporal.Duration.prototype.round(), bao gồmlargestUnit,roundingIncrement,roundingMode, vàsmallestUnit.largestUnitvàsmallestUnitchỉ chấp nhận các đơn vị:"hours","minutes","seconds","milliseconds","microseconds","nanoseconds", hoặc dạng số ít của chúng. Đối vớilargestUnit, giá trị mặc định"auto"có nghĩa là"hours". Đối vớismallestUnit, giá trị mặc định là"nanoseconds".
Giá trị trả về
Một đối tượng Temporal.Duration mới đại diện cho khoảng thời gian kể từ other đến thời điểm này. Khoảng thời gian là dương nếu other đứng trước thời điểm này, và âm nếu đứng sau.
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 since()
const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.since(lunchTime);
console.log(`You had lunch ${duration.toLocaleString("en-US")} ago`);
// Ví dụ đầu ra: "You had lunch 3 hr, 42 min, 21 sec, 343 ms, 131 μs, 718 ns ago"
const duration2 = now.since(lunchTime, { smallestUnit: "minutes" });
console.log(`You had lunch ${duration2.toLocaleString("en-US")} ago`);
// Ví dụ đầu ra: "You had lunch 3 hr, 42 min ago"
const duration3 = now.since(lunchTime, {
largestUnit: "minutes",
smallestUnit: "minutes",
});
console.log(`You had lunch ${duration3.toLocaleString("en-US")} ago`);
// Ví dụ đầu ra: "You had lunch 222 min ago"
Làm tròn kết quả
Theo mặc định, phần thập phân của smallestUnit bị cắt bớt. Bạn có thể làm tròn lên bằng cách sử dụng các tùy chọn roundingIncrement và roundingMode.
const time1 = Temporal.PlainTime.from("12:30:00");
const time2 = Temporal.PlainTime.from("12:30:01");
const duration = time2.since(time1, {
smallestUnit: "seconds",
roundingIncrement: 15,
roundingMode: "ceil",
});
console.log(duration.toString()); // "PT15S"
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.since |