Date.prototype.getFullYear()
< JavaScript | Date
الدالة 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.