JavaScript Date setFullYear() 方法

setFullYear() 方法是 JavaScript 中一個內建函式，用於設定 Date 物件的“年份”元件。此方法的返回值是 Date 物件的更新時間戳，反映了透過修改年份所做的更改。或者，我們還可以修改日期物件的月份和日期值。

如果傳遞給此方法的任何引數為 NaN 或未定義，則日期將設定為“無效日期”，並且 Not a Number (NaN) 將作為結果返回。

語法

以下是 JavaScript Date setFullYear() 方法的語法：

setFullYear(yearValue, monthValue, dateValue);

引數

此方法接受三個引數。下面描述了相同的內容：

yearValue - 一個整數，表示新的年份（四位數字）。
monthValue (可選) - 一個介於 0 和 11 之間的整數，其中 0 表示 1 月，11 表示 12 月。
- 如果提供 -1，則將導致前一年的最後一個月。
- 如果提供 12，則將導致下一年的第一個月。
dateValue (可選) - 一個介於 1 和 31 之間的整數。
- 如果提供 0，則將導致前一個月的最後一天。
- 如果提供 -1，則將導致前一個月的倒數第二天。
- 如果提供 32，則將導致下一個月的第一天（如果該月有 31 天）。
- 如果提供 32，則將導致下一個月的第二天（如果該月有 30 天）。

返回值

setFullYear() 方法在設定年份後返回更新的日期物件的時間戳。

示例 1

在以下示例中，我們使用 JavaScript Date setFullYear() 方法將 Date 物件的年份設定為 2023：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setFullYear(2023);

   document.write(currentDate);
</script>
</body>
</html>

輸出

如果我們執行上述程式，年份將設定為 2023，月份和日期將根據本地時間。

示例 2

在這裡，我們將年份設定為 (2023)，月份設定為 10 (11 月)，日期設定為 (25)：

<html>
<body>
<script>
   const specificDate = new Date();
   specificDate.setFullYear(2023, 10, 25);

   document.write(specificDate);
</script>
</body>
</html>

輸出

執行後，此程式返回一個具有指定日期的時間戳。

示例 3

在此示例中，我們只更改年份，同時保持現有月份 (5 月) 和日期 (15) 不變。

<html>
<body>
<script>
   const existingDate = new Date('2022-05-15');
   existingDate.setFullYear(2023);

   document.write(existingDate);
</script>
</body>
</html>

輸出

它返回一個時間戳，例如“2023 年 5 月 15 日星期一 05:30:00 GMT+0530 (印度標準時間)”。

示例 4

如果我們為 monthValue 指定“12”，則年份將增加 1 (yearValue + 1)，並且 0 將用於月份。

<html>
<body>
<script>
   const existingDate = new Date('2022-11-15'); //December 15 2022
   existingDate.setFullYear(2022, 12, 15); // It will be January 15 2023

   document.write(existingDate);
</script>
</body>
</html>

輸出

它返回一個時間戳，例如“2023 年 1 月 15 日星期日 05:30:00 GMT+0530 (印度標準時間)”。

示例 5

如果我們為 dateValue 指定“32”，則月份將增加 1（如果該月有 31 天），並將導致下一個月的第一天。

<html>
<body>
<script>
   const existingDate = new Date('2023-10-30'); //October 2023 has 31 days.
   existingDate.setFullYear(2023, 9, 32); 

   document.write(existingDate);
</script>
</body>
</html>

輸出

它返回一個時間戳，例如“2023 年 11 月 1 日星期三 05:30:00 GMT+0530 (印度標準時間)”。

示例 6

如果我們將無效的日期值作為引數傳遞給此函式，則日期將設定為“無效日期”，並且“NaN”將作為結果返回：

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setFullYear("dfbgf");

   document.write(currentDate.getUTCFullYear());
</script>
</body>
</html>

輸出

正如我們所看到的輸出，“NaN”作為輸出返回。

列印頁面