Javascript date.setUTCFullYear()用法及代碼示例

date.setUTCFullYear()是JavaScript中的內置函數，用於根據使用date()構造函數創建的通用時間將年份設置為日期對象。

用法:

DateObj.setUTCFullYear(year_Value);

DateObj是使用Date()構造函數創建的有效Date對象，我們要在其中設置年份。

參數：在這裏，參數year_Value是在date()構造函數中設置的年份值。

返回值：它根據setUTCFullYear()函數設置的通用時間返回新的即更新的年份。

以下示例程序旨在說明setUTCFullYear()函數：

<script> 
// Here a date has been assigned according 
// to universal time while creating Date object 
var dateobj = new Date('October 13, 1996 05:35:32 GMT-3:00'); 
  
// new year 1992 is being set in above Date 
// Object with the help of setUTCFullYear() function 
dateobj.setUTCFullYear(1992); 
  
// new year from above Date Object is 
// being extracted using getUTCFullYear() 
var B = dateobj.getUTCFullYear(); 
  
// Printing new year 
document.write(B); 
</script>

輸出：

1992

錯誤和異常

• 示例1:如果在Date()構造函數中沒有給出任何年份，則setUTCFullYear()函數仍將能夠根據作為其參數給出的通用時間設置新的年份。

  <script> 
  // Here year according to universal time has not 
  // been assigned while creating Date object 
  var dateobj = new Date('October 13, 05:35:32 GMT-3:00'); 
    
  // new year 1992 is being set in above Date 
  // Object with the help of setUTCFullYear() function 
  dateobj.setUTCFullYear(1992); 
    
  // new year from above Date Object is 
  // being extracted using getUTCFullYear() 
  var B = dateobj.getUTCFullYear(); 
    
  // Printing new year 
  document.write(B); 
  </script>

  輸出：

  1992

• 示例2:如果在Date()構造函數中未提供任何參數，則setUTCFullYear()函數仍然可以在創建的Date對象中設置年，但是月份和日期仍為當前日期。

  <script> 
  // Here nothing has been assigned 
  // while creating Date object 
  var dateobj = new Date(); 
    
  // new year 2007 is being set in above Date 
  // Object with the help of setUTCFullYear() function 
  dateobj.setUTCFullYear(2007); 
    
  // Year from above Date Object is 
  // being extracted using getUTCFullYear() 
  var B = dateobj.getUTCFullYear(); 
    
  // month from above Date Object is 
  // being extracted using getUTCMonth() 
  var C = dateobj.getUTCMonth(); 
    
  // date from above Date Object is 
  // being extracted using getUTCDate() 
  var D = dateobj.getUTCDate(); 
    
  // Printing new year 
  document.write(B + "<br>"); 
    
  // Printing current month 
  document.write(C + "<br>"); 
    
  // Printing current date 
  document.write(D); 
  </script>

  輸出：

  2007
  2
  30

  在輸出2中，這裏是3月，因為月份名稱從0到11開始，即1月為0,12月為11。
  並且30是當前日期。

支持的瀏覽器：JavaScript date.setUTCFullYear()函數支持的瀏覽器如下：

• 穀歌瀏覽器
• IE瀏覽器
• 火狐瀏覽器
• Opera
• 蘋果瀏覽器