Date.prototype.setYear()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

الدالة Date.prototype.setYear()‎ تضبط السنة للتاريخ المُحدَّد وفقًا للتوقيت المحلي، ولأنَّ هذه الدالة لا تُعيد السنة كاملةً (مشكلة العام 2000) فلم تعد مستخدمةً ويجب استعمال الدالة setFullYear()‎ بدلًا منها.

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

dateObj.setYear(yearValue)

yearValue

عدد صحيح يُمثِّل السنة.

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

كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا).

الوصف

إذا كانت قيمة yearValue بين 0 و 99، فستُضبَط السنة للكائن dateObj إلى 1900 + yearValue؛ فيما عدا ذلك، ستُضبَط السنة للكائن dateObj إلى yearValue.

أمثلة

مثال عن استخدام الدالة setYear()‎، إذ سنضبط السنة إلى 1996 في أوّل سطرين، والسطر الثالث سيضبطها إلى عام 2000:
var theBigDay = new Date();

theBigDay.setYear(96);
theBigDay.setYear(1996);
theBigDay.setYear(2000);

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

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

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