عرض مصدر JavaScript/Date/getTimezoneOffset

<noinclude>{{DISPLAYTITLE:<code>Date.prototype.getTimezoneOffset()‎</code>}}</noinclude>
الدالة <code>Date.prototype.getTimezoneOffset()‎</code> تعيد الفرق بين المنطقة الزمنية للمحليّة (locale، اي إعدادات الجهاز المحلي) وتوقيت UTC بالدقائق.

== البنية العامة ==
<syntaxhighlight lang="javascript">
dateObj.getTimezoneOffset()

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

== الوصف ==
تُعيد هذه الدالة الفرق بين المنطقة الزمنية المحليّة وتوقيت UTC، لاحظ أنَّ الفرق سيكون موجبًا إذا كان توقيت المنطقة الزمنية المحليّة يسبق توقيت UTC، وسالبًا إذا كان توقيت المنطقة الزمنية المحليّة يلي توقيت UTC. مثلًا، لو كنّا في المنطقة الزمنية UTC+10:00 (توقيت شرق أستراليا) فالقيمة المُعادة من هذه الدالة هي -600.
{| class="wikitable"
!المحلية
!UTC-8
!UTC
!UTC+3
|-
!القيمة المعادة
|480
|0
| -180
|}
لاحظ أنَّ القيمة المُعادة من هذه الدالة ليست ثابتة دومًا في منطقة زمنية معيّنة، ذلك لأنَّ هذه الدالة تأخذ تأثير التوقيت الصيفي ([[wikipedia:Daylight_saving_time|daylight saving]]) بالحسبان.

== أمثلة ==
استخدام الدالة <code>getTimezoneOffset()‎</code> للحصول على الفارق الزمني بين الجهاز المحلي وتوقيت UTC:<syntaxhighlight lang="javascript">
// الحصول على فرق التوقيت من الزمن الحالي
var x = new Date();
var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60;

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

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-date.prototype.gettimezoneoffset ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-date.prototype.gettimezoneoffset ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.26 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Date|{{SUBPAGENAME}}]]