--- title: Date.prototype.getTime() slug: Web/JavaScript/Reference/Global_Objects/Date/getTime tags: - Date - JavaScript - Method - Prototype - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Date/getTime ---
{{JSRef("Global_Objects", "Date")}}

Метод getTime() возвращает числовое значение, соответствующее указанной дате по всемирному координированному времени.

Вы можете использовать этот метод для того, чтобы присвоить дату и время другому объекту {{jsxref("Global_Objects/Date", "Date")}}. Этот метод функционально эквивалентен методу {{jsxref("Date.prototype.valueof", "valueOf()")}}.

{{EmbedInteractiveExample("pages/js/date-gettime.html")}}

Синтаксис

dateObj.getTime()

Параметры

Нет.

Возвращаемое значение

Значение, возвращённое методом getTime(), является количеством миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC.

Примеры

Пример: использование метода getTime() для копирования дат

Конструирует новый объект даты с идентичным значением времени.

let birthday = new Date(2020, 12, 20);
let copy = new Date();
copy.setTime(birthday.getTime());

console.log(copy.setTime(birthday.getTime())); // 1611090000000

Пример: замер времени выполнения

Вычитанием двух последовательных вызовов метода getTime() на заново сконструированных объектах {{jsxref("Global_Objects/Date", "Date")}} можно замерить промежуток времени, произошедший между двумя этими вызовами. Это можно использовать для вычисления времени выполнения неких операций.

let end, start;

start = new Date();
for (let i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
end = new Date();

console.log('Операция заняла ' + (end.getTime() - start.getTime()) + ' мсек');

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

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.9.5.9', 'Date.prototype.getTime')}} {{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}} {{Spec2('ES6')}}

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

{{Compat("javascript.builtins.Date.getTime")}}

Смотрите также