Date.prototype.getUTCFullYear()
< JavaScript | Date
الدالة Date.prototype.getUTCFullYear() تعيد السنة (أربعة أرقام) للتاريخ المُحدَّد وفقًا للتوقيت العالمي.
البنية العامة
dateObj.getUTCFullYear()
القيمة المعادة
عددٌ صحيحٌ يُمثِّل السنة للتاريخ المعطي وفقًا للتوقيت العالمي.
الوصف
القيمة المُعادة من الدالة getUTCFullYear() هي رقمٌ مطلق (أي ليس نسبةً إلى العام 1900)، فللتواريخ التي تقع بين عامَي 1000 و 9999 ستُعيد الدالة getUTCFullYear() قيمةً عدديةً مكونةً من أربعة أرقام (مثلًا: 1995).
أمثلة
المثال الآتي يُسنِد قيمة السنة الحالية (عددٌ صحيحٌ يتألف من أربعة أرقام) إلى المتغير year:
var today = new Date();
var year = today.getUTCFullYear();
دعم المتصفحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 1st Edition.