Date.prototype.valueOf()
Базовый уровень Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Метод valueOf() экземпляров Date возвращает количество миллисекунд для этой даты с момента эпохи, которая определяется как полночь в начале 1 января 1970 года, UTC.
Попробуйте
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
Синтаксис
valueOf()
Параметры
Нет.
Возвращаемое значение
Число, представляющее временную метку этой даты в миллисекундах. Возвращает NaN, если дата недействительна.
Описание
Метод valueOf() является частью протокола приведения типов. Поскольку Date имеет метод [Symbol.toPrimitive](), этот метод всегда имеет приоритет над valueOf(), когда объект Date неявно приводится к числу. Однако Date.prototype[Symbol.toPrimitive]() все равно вызывает this.valueOf() внутри.
Объект Date переопределяет метод valueOf() из Object. Date.prototype.valueOf() возвращает временную метку даты, которая функционально эквивалентна методу Date.prototype.getTime().
Примеры
Использование valueOf()
const d = new Date(0); // 1970-01-01T00:00:00.000Z console.log(d.valueOf()); // 0
Спецификации
Совместимость с браузерами
| Настольный ПК | Мобильные устройства | Сервер | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on iOS | Samsung Internet | WebView Android | WebView on iOS | Bun | Deno | Node.js | |
valueOf |
1 |
12 |
1 |
3 |
1 |
18 |
4 |
10.1 |
1 |
1.0 |
4.4 |
1 |
1.0.0 |
1.0 |
0.10.0 |
См. также
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/valueOf