JavaScript Date.setFullYear() 方法详解

作者:函数茶馆时间:2026-10-29 10:57:00浏览:385

本文详细介绍 JavaScript Date 对象的 setFullYear() 方法,用于按本地时间设置年份。该方法支持可选的月份和日期参数,若未指定则沿用现有值。通过实际代码示例展示了如何修改 Date 实例的年份,并说明了返回值情况,帮助开发者准确掌握日期操作技巧。

setFullYear() 方法概述

JavaScript 的 Date 对象提供了 setFullYear() 方法,用于按照本地时间设置指定年份的日期。


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

参数说明与使用规则

需要注意的是,该方法括号内的参数均为可选参数。

以下是各参数的详细说明:

  • yearValue:一个整数,表示需要设置的年份数值,例如 2008。
  • monthValue:一个从 0 到 11 的整数,分别代表一月到十二月。
  • dayValue:一个介于 1 到 31 之间的整数,表示一个月中的某一天。如果提供了 dayValue 参数,则必须同时提供 monthValue 参数。

如果未指定 monthValue 和 dayValue 参数,getMonth() 和 getDate() 方法返回的值将被保留使用。

  • 返回值:NA(无特定返回值)

代码示例与结果

以下是一个具体的应用示例:


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

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


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

作者最新文章