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
الدعم الأساسي نعم نعم نعم نعم نعم

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