CodePlayer

setUTCMonth()函数用于基于UTC时间设置当前Date对象中的月份值。也就是"年月日"中"月"的数值。setUTCMonth()函数还可同时设置日期值。

该函数属于Date对象，所有主流浏览器均支持该函数。

语法

date.setUTCMonth( month[, dateValue ] )

参数

setUTCMonth()函数的所有参数都可以超出常规取值范围。例如：参数month可以超出常规的0 ~ 11的取值范围；参数dateValue可以超出常规的1 ~ 31的取值范围；并且都可以为负数。Date对象内部会自动计算并转换为相应的日期。
注意，参数month的值比实际月份小1。

返回值

setUTCMonth()函数没有返回值(或者说，返回值为undefined)。

示例&说明

// 当前运行环境的时区为 UTC +8

//定义一个本地时间的Date对象"2013-05-15 00:00:00"
// 对应的UTC时间为"2013-05-14 16:00:00"
var date = new Date(2013, 4, 15, 0, 0, 0);
document.writeln( date.toLocaleString() ); // 2013年5月15日 0:00:00

date.setUTCMonth(0);
document.writeln( date.toLocaleString() ); // 2013年1月15日 0:00:00

// 此时的UTC时间为"2013-01-14 16:00:00"
date.setUTCMonth(-15, 2);
// 设置完毕后，UTC为"2013-(-14)-(02) 16:00:00" 即"2011-10-02 16:00:00"
// 输出本地时间即为"2011-10-03 00:00:00"
document.writeln( date.toLocaleString() ); // 2011年10月3日 0:00:00

date.setUTCMonth(12, 5);
document.writeln( date.toLocaleString() ); // 2012年1月6日 0:00:00

运行代码