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

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