JavaScript Date setUTCFullYear() 方法

JavaScript 的 Date.setUTCFullYear() 方法用於根據協調世界時 (UTC) 設定 Date 物件的年份。此方法允許您修改 Date 物件的年份部分，而不更改其他日期部分（如月份或日期）。

此方法的返回值是 Date 物件的更新時間戳，它反映了透過修改年份所做的更改。或者，我們也可以修改日期物件的月份和日期值。

語法

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

setUTCFullYear(yearValue, monthValue, dateValue);

引數

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

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

返回值

setUTCFullYear() 的返回值是在 1970 年 1 月 1 日和設定年份後的更新 Date 物件之間經過的毫秒數。

示例 1

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

<html>
<body>
<script>
   const currentDate = new Date();
   currentDate.setUTCFullYear(2025);

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

輸出

如果我們執行上述程式，年份將被設定為 2023。

示例 2

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

<html>
<body>
   const specificDate = new Date();
   specificDate.setUTCFullYear(2024, 10, 25); //Will set to November 25, 2024

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

輸出

執行此程式後，它將返回具有提供的日期的時間戳。

示例 3

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

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

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

輸出

它返回的時間戳為“Sun Jan 15 2024 05:30:00 GMT+0530 (India Standard Time)”。

示例 4

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

<html>
<body>
<script>
   const existingDate = new Date('2024-03-30'); //March 2024 has 31 days.
   existingDate.setUTCFullYear(2024, 2, 32); 

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

輸出

它返回的時間戳為“Mon Apr 01 2024 05:30:00 GMT+0530 (India Standard Time)”。

示例 5

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

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

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

輸出

如我們所見，輸出為“NaN”。

列印頁面