JavaScript Date.setUTCFullYear() 方法详解

setUTCFullYear() 方法概述

JavaScript 的 Date 对象提供了 setUTCFullYear() 方法，用于按照通用协调时间（UTC）设定日期的年份部分。

Date.setUTCFullYear(yearValue[, monthValue[, dayValue]])

需要注意的是，该方法括号内的后两个参数（月份和日期）是可选的。

以下是该方法各参数的详细说明：

• yearValue：一个整数，代表要设置的年份数值，例如 2008。
• monthValue：一个介于 0 到 11 之间的整数，表示月份。其中 0 代表一月，11 代表十二月。
• dayValue：一个介于 1 到 31 之间的整数，表示该月的具体日期。如果提供了 dayValue 参数，则必须同时提供 monthValue 参数。

参数越界处理机制

如果未指定 monthValue 和 dayValue 参数，Date 对象将保留由 getMonth() 和 getDate() 方法返回的当前值。如果提供的参数超出了预期范围，setUTCFullYear() 会尝试自动更新其他相关参数及日期信息。例如，若 monthValue 指定为 15，年份将自动增加 1（即年+1），而月份则调整为表示第 3 个月。

• 返回值：该方法不返回任何值（NA）。

代码示例与结果

以下是一个具体的使用示例：

<html>
<head>
<title>JavaScript setUTCFullYear Method</title>
</head>
<body>
<script type="text/javascript">
  var dt = new Date( "Aug 28, 2008 23:30:00" );
  dt.setUTCFullYear( 2006 );
  document.write( dt ); 
</script>
</body>
</html>

执行上述代码将产生如下结果：

Mon Aug 28 23:30:00 UTC+0530 2006