مетод setFullYear() شیء تاریخ JavaScript

تعریف و استفاده

setFullYear() این روش برای تنظیم سال یک شیء تاریخ (با عدد چهار رقمی بین 1000 تا 9999) استفاده می‌شود.

این روش همچنین می‌تواند برای تنظیم ماه و روز ماه استفاده شود.

مثال

مثال 1

سال را به 2020 تنظیم کنید:

var d = new Date();
d.setFullYear(2020);

آزمایش کنید

مثال 2

مثال

تاریخ را به 3 نوامبر 2020 تنظیم کنید:

var d = new Date();
d.setFullYear(2020, 10, 3);

آزمایش کنید

مثال 3

تاریخ را به شش ماه قبل تنظیم کنید:

var d = new Date();
d.setFullYear(d.getFullYear(), d.getMonth() - 6);

آزمایش کنید

نحوه استفاده

Date.setFullYear(سال, ماه, روز)

مقدار پارامتر

پارامتر توضیح
سال ضروری. مقدار نشان‌دهنده سال است، مقدار منفی نیز مجاز است.
ماه

اختیاری. عددی که ماه را نشان می‌دهد.

مقدار پیش‌فرض 0-11 است، اما سایر مقادیر نیز مجاز هستند:

  • -1 منجر به ماه آخر سال قبل خواهد شد
  • 12 منجر به ماه اول سال بعد خواهد شد
  • 13 منجر به ماه دوم سال بعد خواهد شد
روز

اختیاری. عددی که نشان‌دهنده روز در ماه است.

مقدار پیش‌فرض 1-31 است، اما سایر مقادیر نیز مجاز هستند:

  • 0 منجر به آخرین روز ماه قبل خواهد شد
  • -1 منجر به روز قبل از آخرین روز ماه قبل خواهد شد

اگر ماه 31 روز داشته باشد:

  • 32 منجر به روز اول ماه بعد خواهد شد

اگر ماه 30 روز داشته باشد:

  • 32 منجر به روز دوم ماه بعد خواهد شد

جزئیات فنی

مقدار بازگشتی: عدد، که میزان میلiseconds بین شیء تاریخ و نیمه شب 1 ژانویه 1970 را نشان می‌دهد.
نسخه JavaScript: ECMAScript 1

پشتیبانی مرورگر

روش Chrome IE Firefox Safari Opera
setFullYear() پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

آموزش:تاریخ JavaScript

آموزش:قالب تاریخ JavaScript

آموزش:روش‌های تنظیم تاریخ JavaScript