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

<noinclude>{{DISPLAYTITLE:<code>Date.prototype.getYear()‎</code>}}</noinclude>
الدالة <code>Date.prototype.getYear()‎</code> تعيد السنة للتاريخ المُحدَّد وفقًا للتوقيت المحلي، ولأنَّ هذه الدالة لا تُعيد السنة كاملةً ([https://ar.wikipedia.org/wiki/مشكلة_عام_2000 مشكلة العام 2000]) فلم تعد مستخدمةً ويجب استعمال الدالة <code>[[JavaScript/Date/getFullYear|getFullYear()‎]]</code> بدلًا منها.

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

</syntaxhighlight>
=== القيمة المعادة ===
عددٌ صحيحٌ يُمثِّل السنة للتاريخ المعطي وفقًا للتوقيت المحلي، مطروحًا منه 1900.

== الوصف ==
* للسنوات التي تكون أكبر أو تساوي 2000، فستكون القيمة المُعادة من الدالة <code>getYear</code> أكبر أو تساوي 100. على سبيل المثال، لو كانت السنة هي 2026، فستُعيد الدالة <code>getYear</code> القيمة 126.
* للسنوات بين 1900 و 1999، ستكون القيمة المعادة من الدالة <code>getYear</code> بين 0 و 99. فمثلًا لو كانت السنة هي 1976، فستُعيد الدالة <code>getYear</code> القيمة 76.
* للسنوات الأقل من 1900، فستكون القيمة المُعادة من الدالة <code>getYear</code> أصغر من الصفر، أي لو كانت السنة هي 1800، فستُعيد الدالة <code>getYear</code> القيمة -100.
من المستحسن استخدام الدالة <code>[[JavaScript/Date/getFullYear|getFullYear()‎]]</code> بدلًا من الدالة <code>getYear()‎</code> لأنها تُعيد السنة كاملةً.

== أمثلة ==

=== السنوات بين 1900 و 1999 ===
المثال الآتي يُسنِد القيمة 95 إلى المتغير <code>year</code>:<syntaxhighlight lang="javascript">
var Sday = new Date('May 21, 1995 23:15:00');
var year = Sday.getYear(); // 95

</syntaxhighlight>

=== السنوات الأكبر من 1999 ===
المثال الآتي يُسنِد القيمة 100 إلى المتغير <code>year</code>:<syntaxhighlight lang="javascript">
var Sday = new Date('May 21, 2000 23:15:00');
var year = Sday.getYear(); // 100

</syntaxhighlight>

=== السنوات الأصغر من 1900 ===
المثال الآتي يُسنِد القيمة -100 إلى المتغير <code>year</code>:<syntaxhighlight lang="javascript">
var Sday = new Date('May 21, 1800 23:15:00');
var year = Sday.getYear(); // -100

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-date.prototype.getyear ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-date.prototype.getyear ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-B.2.4 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}}]]