`Date.prototype.getYear()‎`

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

الدالة Date.prototype.getYear()‎ تعيد السنة للتاريخ المُحدَّد وفقًا للتوقيت المحلي، ولأنَّ هذه الدالة لا تُعيد السنة كاملةً (مشكلة العام 2000) فلم تعد مستخدمةً ويجب استعمال الدالة getFullYear()‎ بدلًا منها.

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

dateObj.getYear()

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

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

الوصف

للسنوات التي تكون أكبر أو تساوي 2000، فستكون القيمة المُعادة من الدالة getYear أكبر أو تساوي 100. على سبيل المثال، لو كانت السنة هي 2026، فستُعيد الدالة getYear القيمة 126.
للسنوات بين 1900 و 1999، ستكون القيمة المعادة من الدالة getYear بين 0 و 99. فمثلًا لو كانت السنة هي 1976، فستُعيد الدالة getYear القيمة 76.
للسنوات الأقل من 1900، فستكون القيمة المُعادة من الدالة getYear أصغر من الصفر، أي لو كانت السنة هي 1800، فستُعيد الدالة getYear القيمة -100.

من المستحسن استخدام الدالة getFullYear()‎ بدلًا من الدالة getYear()‎ لأنها تُعيد السنة كاملةً.

أمثلة

السنوات بين 1900 و 1999

المثال الآتي يُسنِد القيمة 95 إلى المتغير year:

var Sday = new Date('May 21, 1995 23:15:00');
var year = Sday.getYear(); // 95

السنوات الأكبر من 1999

المثال الآتي يُسنِد القيمة 100 إلى المتغير year:

var Sday = new Date('May 21, 2000 23:15:00');
var year = Sday.getYear(); // 100

السنوات الأصغر من 1900

المثال الآتي يُسنِد القيمة -100 إلى المتغير year:

var Sday = new Date('May 21, 1800 23:15:00');
var year = Sday.getYear(); // -100

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

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

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

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