Date.prototype.getTimezoneOffset()‎

الدالة Date.prototype.getTimezoneOffset()‎ تعيد الفرق بين المنطقة الزمنية للمحليّة (locale، اي إعدادات الجهاز المحلي) وتوقيت UTC بالدقائق.

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

dateObj.getTimezoneOffset()

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

عددٌ صحيحٌ يُمثِّل الفرق بين المنطقة الزمنية للمحليّة (locale) وتوقيت UTC بالدقائق.

الوصف

تُعيد هذه الدالة الفرق بين المنطقة الزمنية المحليّة وتوقيت UTC، لاحظ أنَّ الفرق سيكون موجبًا إذا كان توقيت المنطقة الزمنية المحليّة يسبق توقيت UTC، وسالبًا إذا كان توقيت المنطقة الزمنية المحليّة يلي توقيت UTC. مثلًا، لو كنّا في المنطقة الزمنية UTC+10:00 (توقيت شرق أستراليا) فالقيمة المُعادة من هذه الدالة هي -600.

المحلية	UTC-8	UTC	UTC+3
القيمة المعادة	480	0	-180

لاحظ أنَّ القيمة المُعادة من هذه الدالة ليست ثابتة دومًا في منطقة زمنية معيّنة، ذلك لأنَّ هذه الدالة تأخذ تأثير التوقيت الصيفي (daylight saving) بالحسبان.

أمثلة

استخدام الدالة getTimezoneOffset()‎ للحصول على الفارق الزمني بين الجهاز المحلي وتوقيت UTC:

// الحصول على فرق التوقيت من الزمن الحالي
var x = new Date();
var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60;

// الحصول على فرق التوقيت في أوّل أيام شهر أيار/مايو
// تذكر أنَّ عدّ الأشهر يبدأ من 0، أي أنَّ شهر أيام/مايو هو 4
var labourDay = new Date(2017, 4, 1)
var labourDayOffset = labourDay.getTimezoneOffset() / 60;

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

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

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

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