Spec-Zone.ru › JavaScript

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

Спецификации

Спецификация
ECMAScript® 2027 Language Specification
# sec-date.prototype.valueof

Совместимость с браузерами

Настольный ПК Мобильные устройства Сервер
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

См. также

  • Object.prototype.valueOf()
  • Date.prototype.getTime()

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API