Date.prototype.getFullYear()‎

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

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

dateObj.getFullYear()

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

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

الوصف

القيمة المُعادة من الدالة getFullYear()‎ هي رقمٌ مطلق (أي ليس نسبةً إلى العام 1900 كما في دالة getYear()‎)، فللتواريخ التي تقع بين عامَي 1000 و 9999 ستُعيد الدالة getFullYear()‎ قيمةً عدديةً مكونةً من أربعة أرقام (مثلًا: 1995).

أمثلة

المثال الآتي يُسنِد قيمة السنة الحالية (عددٌ صحيحٌ يتألف من أربعة أرقام) إلى المتغير year:

var today = new Date();
var year = today.getFullYear();

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

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

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

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