Date.prototype.valueOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Phương thức valueOf() của các instance Date trả về số mili giây của ngày này kể từ epoch, được định nghĩa là nửa đêm đầu ngày 1 tháng 1 năm 1970, UTC.

Try it

const date1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));

console.log(date1.valueOf());
// Expected output: 823230245000

const date2 = new Date("02 Feb 1996 03:04:05 GMT");

console.log(date2.valueOf());
// Expected output: 823230245000

Cú pháp

js
valueOf()

Tham số

Không có.

Giá trị trả về

Một số đại diện cho timestamp, tính bằng mili giây, của ngày này. Trả về NaN nếu ngày không hợp lệ.

Mô tả

Phương thức valueOf() là một phần của giao thức ép kiểu. Vì Date có phương thức [Symbol.toPrimitive](), phương thức đó luôn được ưu tiên hơn valueOf() khi một đối tượng Date được ngầm ép kiểu thành số. Tuy nhiên, Date.prototype[Symbol.toPrimitive]() vẫn gọi this.valueOf() nội bộ.

Đối tượng Date ghi đè phương thức valueOf() của Object. Date.prototype.valueOf() trả về timestamp của ngày, tương đương về mặt chức năng với phương thức Date.prototype.getTime().

Ví dụ

Sử dụng valueOf()

js
const d = new Date(0); // 1970-01-01T00:00:00.000Z
console.log(d.valueOf()); // 0

Đặc tả kỹ thuật

Specification
ECMAScript® 2027 Language Specification
# sec-date.prototype.valueof

Tương thích trình duyệt

Xem thêm