本文详细介绍JavaScript中Date对象的setUTCMinutes()方法,用于按通用时间设置分钟。该方法支持可选的秒和毫秒参数,并具备自动处理数值溢出(如分钟进位)的功能。通过具体代码示例展示其实际应用及返回值说明。
setUTCMinutes方法概述
在JavaScript中,Date对象的setUTCMinutes()方法用于按照通用协调时间(UTC)设定指定日期的分钟数。
Date.setUTCMinutes(minutesValue[, secondsValue[, msValue]])
需要注意的是,该方法括号内的部分参数是可选的。
参数详细说明
以下是该方法参数的详细说明:
- minutesValue:一个介于0到59之间的整数,代表分钟数。
- secondsValue:一个介于0到59之间的整数,代表秒数。如果提供了secondsValue参数,则必须同时提供minutesValue参数。
- msValue:一个介于0到999之间的数字,代表毫秒数。如果提供了msValue参数,则必须同时提供minutesValue和secondsValue参数。
若未指定secondsValue和msValue参数,系统将自动使用getUTCSeconds和getUTCMilliseconds方法当前返回的值。
当提供的参数超出预期范围时,setUTCMinutes会尝试相应地更新Date对象的信息。例如,若secondsValue设置为100,分钟数(minutesValue)将自动加1(即minutesValue+1),而秒数则调整为40。
- 该方法没有返回值(NA)。
代码示例与结果
以下是具体的使用示例:
<html>
<head>
<title>JavaScript setUTCMinutes Method</title>
</head>
<body>
<script type="text/javascript">
var dt = new Date( "Aug 28, 2008 13:30:00" );
dt.setUTCMinutes( 65 );
document.write( dt );
</script>
</body>
</html>
执行上述代码将产生如下结果:
Thu Aug 28 14:35:00 UTC+0530 2008