本文介绍 JavaScript Date 对象的 setUTCFullYear() 方法,用于按通用协调时间(UTC)设置年份。该方法支持可选的月份和日期参数,若未指定则沿用现有值。当传入超出范围的数值时,引擎会自动进行进位或借位调整。文章包含语法说明、参数详解及完整运行示例,展示如何修改日期年份并获取结果。
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