JavaScript setUTCFullYear() 方法

Date 对象参考手册 JavaScript Date 对象

设置年份为1992:

<p id="demo">单击按钮来显示改变年份后的一个日期。</p>
<button onclick="myFunction()">点我</button>
<script>
  function myFunction() {
    var d = new Date();
    d.setUTCFullYear(2020);
    var x = document.getElementById("demo");
    x.innerHTML = d;
  }
</script>

尝试一下 »


定义和用法

setUTCFullYear() 方法用于根据世界时 (UTC) 设置年份。

提示: 协调世界时,又称世界统一时间,世界标准时间,国际协调时间,简称UTC( Universal Coordinated Time)。

提示:UTC 时间就为 GMT(格林尼治) 时间。


浏览器支持

Internet ExplorerFirefoxOperaGoogle ChromeSafari

所有主要浏览器都支持 setUTCFullYear() 方法。


语法

Date.setUTCFullYear(year, month, day)

参数值

参数 描述
year 必需。要给 dateObject 设置的年份字段的值。
该参数应该是含有世纪值的完整年份,如 1999,而不只是缩写的年份值,比如 99。
month 可选。要给 dateObject 设置的月份字段的值。使用世界时表示。

该参数是 0 ~ 11 之间的整数:

  • -1 为前一年的最后一个月
  • 12 为明年的第一个月
  • 13 明年的第二个月
day 可选。要给 dateObject 设置的天字段的值。使用世界时表示。

该参数是 1 ~ 31 之间的整数:

  • 0 为上一个月的最后一小时。
  • -1 为上一个月的最后一小时的前一小时时间

如果当前月份有 31 天:

  • 32 为下一个月的第一天

如果当前月份为 30 天:

  • 32 为下一个月的第二天

Return Value

类型 描述
Number 1970年1月1日至调整过的日期的毫秒数。

技术细节

JavaScript 版本: 1.3

更多实例

设置日期为2020年10月3日:

<p id="demo">单击按钮后显示一个修改年、月和日后日期。</p>
<button onclick="myFunction()">点我</button>
<script>
  function myFunction() {
    var d = new Date();
    d.setUTCFullYear(2020, 10, 3);
    var x = document.getElementById("demo");
    x.innerHTML = d;
  }
</script>

尝试一下 »


根据世界时 (UTC) 设置日日期为6个月前:

<p id="demo">单击按钮来显示六个月前的日期。</p>
<button onclick="myFunction()">点我</button>
<script>
  function myFunction() {
    var d = new Date();
    d.setUTCFullYear(d.getUTCFullYear(), d.getUTCMonth() - 6);
    var x = document.getElementById("demo");
    x.innerHTML = d;
  }
</script>

尝试一下 »


Date 对象参考手册 JavaScript Date 对象