CodePlayer

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

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

语法

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

参数

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

返回值

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

示例&说明

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

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

// 由于设置的是UTC时间，换算成本地时间，还要+8小时
// 因此本地时间为"2012-03-15 (23+8):11:43" = "2012-03-16 07:11:43"
date.setUTCHours(23);
document.writeln( date.toLocaleString() ); // 2012年3月16日 7:11:43

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

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

运行代码