setUTCFullYear أسلوب

قم بتعيين القيمة السنة في Dateكائن استخدام "توقيت عالمي متفق عليه" (UTC).

function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])

الوسيطات

  • numYear
    مطلوبة. يساوي القيمة رقمية إلى السنة.

  • numMonth
    اختياري. يساوي القيمة رقمية إلى شهر. الالقيمة لشهر يناير هو اتبع قيم شهر 0، وغيرها بشكل متتال. يجب توفير حالة numDateهو الذي تم توفيره.

  • numDate
    اختياري. القيمة رقمية تساوي يوم شهر.

ملاحظات

تعيين وظائف التقاط الوسيطات الاختيارية استخدم إرجاع القيمة من يحصل وظائف مناظرة، إذا لم تقم بتعيين وسيطة اختيارية. على سبيل المثال، إذا كان numMonthتكون وسيطة الاختيارية، ولكن غير محدد، تستخدم JScript القيمة التي يتم إرجاعها من getUTCMonthالأسلوب.

بالإضافة إلى ذلك، إذا كانت قيمة وسيطة هو أكبر التي النطاق الخاص به أو هو يتم ‏‏تاريخ التعديل الأرقام، الأخرى مخزنة قيم سالبة وفقا لذلك.

إلى تعيين السنة استخدام التوقيت المحلي، استخدم setFullYearالأسلوب.

نطاق السنين المعتمدة في Dateالكائن هو 285,616 سنين تقريبا من جانبي 1970.

مثال

يوضح المثال التالي استخدم setUTCFullYearالأسلوب.

var dtFirst = new Date();
dtFirst.setUTCFullYear(2007);

var dtSecond = new Date();
// 10 is the value for November. 
dtSecond.setUTCFullYear(2008, 10, 3); 

print (dtFirst.toUTCString());
print (dtSecond.toUTCString());

المتطلبات

Version 3

يتم تطبيق إلى:

كائن التاريخ

راجع أيضًا:

المرجع

getFullYear أسلوب

getUTCFullYear أسلوب

setFullYear أسلوب