Temporal.PlainDateTime.prototype.valueOf()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức valueOf() của các instance Temporal.PlainDateTime ném ra một TypeError, nhằm ngăn các instance Temporal.PlainDateTime bị chuyển đổi ngầm thành kiểu nguyên thủy khi dùng trong các phép toán số học hoặc so sánh.
Cú pháp
valueOf()
Tham số
Không có.
Giá trị trả về
Không có.
Ngoại lệ
TypeError-
Luôn được ném ra.
Mô tả
Vì cả chuyển đổi nguyên thủy lẫn chuyển đổi số đều gọi valueOf() trước toString(), nếu valueOf() bị thiếu, thì một biểu thức như dateTime1 > dateTime2 sẽ ngầm so sánh chúng dưới dạng chuỗi, điều này có thể cho kết quả không mong đợi. Bằng cách ném ra TypeError, các instance Temporal.PlainDateTime ngăn chặn các chuyển đổi ngầm như vậy. Bạn cần chuyển đổi tường minh sang chuỗi bằng Temporal.PlainDateTime.prototype.toString(), hoặc sử dụng phương thức tĩnh Temporal.PlainDateTime.compare() để so sánh chúng.
Ví dụ
Phép toán số học và so sánh trên Temporal.PlainDateTime
Tất cả các phép toán số học và so sánh trên các instance Temporal.PlainDateTime nên dùng các phương thức chuyên dụng hoặc chuyển đổi tường minh sang kiểu nguyên thủy.
const dt1 = Temporal.PlainDateTime.from("2022-01-01T00:00:00");
const dt2 = Temporal.PlainDateTime.from("2022-07-01T00:00:00");
dt1 > dt2; // TypeError: can't convert PlainDateTime to primitive type
Temporal.PlainDateTime.compare(dt1, dt2); // -1
dt2 - dt1; // TypeError: can't convert PlainDateTime to primitive type
dt2.since(dt1).toString(); // "P181D"
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.valueof |