الفرق بين المراجعتين ل"JavaScript/Date/setYear"

المراجعة الحالية بتاريخ 15:44، 28 يناير 2018

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

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

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

@@ سطر 48: / سطر 48: @@
 * معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-B.2.5 ECMAScript 5.1].
 * معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition].
-[[تصنيف:JavaScript]]
+[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
-[[تصنيف:JavaScript Global Objects]]
+[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
-[[تصنيف:JavaScript Date]]
+[[تصنيف:JavaScript Date|{{SUBPAGENAME}}]]