CodePlayer

setHours()函数用于基于当地时间设置当前Date对象中的小时值。也就是"年月日 时分秒"中"时"的数值。setHours()函数还可同时设置分钟值和秒值以及毫秒值。

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

语法

date.setHours( hours[, minutes[, seconds[, milliseconds ]]] )

参数

setHours()函数的所有参数都可以超出常规取值范围。例如：参数hours可以超出常规的0 ~ 23的取值范围；参数minutes可以超出常规的0 ~ 59的取值范围；并且都可以为负数。Date对象内部会自动计算并转换为相应的日期。
如果提供了指定的可选参数，就必须同时提供位于该参数之前的所有可选参数。

返回值

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

示例&说明

//定义一个Date对象"2012-03-15 13:11:43 123"
var date = new Date(2012, 2, 15, 13, 11, 43, 123);
document.writeln( date.toLocaleString() ); // 2012年3月15日 13:11:43

date.setHours(23);
document.writeln( date.toLocaleString() ); // 2012年3月15日 23:11:43

date.setHours(13, 20, 5);
document.writeln( date.toLocaleString() ); // 2012年3月15日 13:20:05

date.setHours(26, -3, 100);
document.writeln( date.toLocaleString() ); // 2012年3月16日 1:58:40

运行代码