JavaScript/Date/getYear

الدالة 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.