Javascript Date setUTCFullYear() 方法

返回 Javascript Date 对象


定义

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

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

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

语法

该方法的语法如下:

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

参数

  • yearValue - 必需,一个整数,指定年份的数值,例如 2008。
  • monthValue - 可选,0 到 11 之间的整数,表示一月到十二月的月份。
  • dayValue - 可选,一个介于 1 和 31 之间的整数,表示一个月中的某一天。如果指定 dayValue 参数,则还必须指定 monthValue。

如果未指定 monthValue 和 dayValue 参数,则使用从 getMonth 和 getDate 方法返回的值。如果您指定的参数超出预期范围,setUTCFullYear 会相应地尝试更新其他参数和 Date 对象中的日期信息。例如,如果为 monthValue 指定 15,则年份增加 1(年 + 1),月份使用 3。

返回值

1970年1月1日至调整过的日期的毫秒数。

浏览器支持

Internet Explorer Firefox Opera Google Chrome Safari

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

示例

<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 2006 23:30:00 GMT+0800 (中国标准时间)

尝试一下


返回 Javascript Date 对象

查看笔记

扫码一下
查看教程更方便