JavaScript/Date/getTime

الدالة Date.prototype.getTime()‎ تعيد قيمةً رقميةً تُمثِّل التاريخ المُحدَّد وفقًا للتوقيت العالمي.

لاحظ أنَّ الدالة getTime()‎ تستخدم توقيت UTC لتمثيل الوقت، أي لو كان جهاز العميل في منطقةٍ زمنيةٍ ما، فستعطي الدالة getTime()‎ نفس القيمة التي كانت ستُعطيها لمُستخدِم آخر في منطقةٍ زمنيةٍ أخرى.

يمكننا الاستفادة من هذه الدالة بإسناد الوقت والتاريخ إلى كائن Date آخر، ووظيفة هذه الدالة تكافئ الدالة valueOf()‎.

البنية العامة

dateObj.getTime()

القيمة المعادة

عددٌ صحيحٌ يُمثِّل كم ملي ثانية قد مضت منذ ‎1 January 1970 00:00:00 UTC والتاريخ المعطي.

أمثلة

استخدام الدالة getTime()‎ لنسخ التواريخ

لإنشاء كائن من النوع Date له نفس تاريخ كائن آخر، فيمكن الاستعانة بالدالتين getTime()‎ و setTime()‎ كما في المثال الآتي:

// لاحظ أنَّ عدّ الأشهر يبدأ من الصفر، أي أنَّ عيد الميلاد سيكون 
// في 10 كانون الثاني/يناير من عام 1995
var birthday = new Date(1994, 12, 10);
var copy = new Date();
copy.setTime(birthday.getTime());

قياس زمن التنفيذ

إيجاد ناتج طرح القيمتين الزمنيتين (الناتجتين من الدالة getTime()‎) التابعتين إلى كائنَي Date سيعطينا الفرق الزمني بينهما. يمكن الاستفادة مما سبق لحساب زمن تنفيذ بعد العمليات؛ انظر إلى الدالة Date.now()‎ لتفادي تهيئة كائنات Date غير ضرورية:

var end, start;

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

console.log('Operation took ' + (end.getTime() - start.getTime()) + ' msec');

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 1st Edition.