极客笔记JavaScript – Date setMilliseconds() 方法
JavaScript是一种具有广泛应用的编程语言，它的Date对象提供了一系列的API，用于处理日期和时间的相关操作。setMilliseconds()方法是其中之一，用于设置Date对象的毫秒数。该方法会返回被修改后的毫秒数值。
语法
setMilliseconds()方法接收一个参数：要被设置的毫秒数值。它的语法如下：
dateObj.setMilliseconds(millisecondsValue)
其中，dateObj是需要被修改的Date对象的名称，millisecondsValue是需要被设置的毫秒数值，可以介于 0 ~ 999 之间，如果数值超出这个范围，那么它就会被转换为合法的数值。例如，设置大于999的值，实际上等价于将这个值除以1000后取余数。
下面是一个简单的示例，用于说明setMilliseconds()方法的具体用法：
let date = new Date('2022/01/01 00:00:00')
console.log(`原始日期：{date}`)
date.setMilliseconds(500)
console.log(`修改毫秒数后的日期：{date}`)
输出结果：
原始日期：Sat Jan 01 2022 00:00:00 GMT+0800 (China Standard Time)
修改毫秒数后的日期：Sat Jan 01 2022 00:00:00 GMT+0800 (China Standard Time)
从上面的代码中可以看到，在setMilliseconds()方法中传入了一个值为500的参数，将日期对象的毫秒数改为了500。然而由于原始日期的毫秒数为0，所以改变毫秒数并没有对日期对象造成任何影响。让我们在重新运行一个新的代码，看一下当原始日期中包含毫秒数时，这个函数是如何工作的：
let date = new Date('2022/01/01 00:00:00:000')
console.log(`原始日期：{date}`)
date.setMilliseconds(500)
console.log(`修改毫秒数后的日期：{date}`)
输出结果：
原始日期：Sat Jan 01 2022 00:00:00 GMT+0800 (China Standard Time)
修改毫秒数后的日期：Sat Jan 01 2022 00:00:00 GMT+0800 (China Standard Time)
与上面的代码不同的是，这次我们传入的原始日期包含了毫秒数。然而因为该方法仅修改毫秒数，其他部分并不会被改变。所以这个方法执行后，日期对象仍然表示2022年1月1日，并且它的毫秒数变为了500。这个方法不会增加或者减少时间的任何部分，它仅会改变毫秒数。
实例
接下来，我们来看一下此方法在实际开发中的应用场景。下面是一个简单的代码段，演示了如何使用setMilliseconds()方法，按照一定的时间间隔不断地更新网页上的倒计时显示：
<body>
距离2022年1月1日还剩：<span id="countdown">00:00:00:000</span>
</body>
let deadline = new Date('2022/01/01 00:00:00:000')
let countdown = document.getElementById('countdown')
function updateCountdown() {
let now = new Date()
let diff = deadline - now
if (diff <= 0) {
clearInterval(intervalID)
} else {
let hours = Math.floor(diff / (1000 * 60 * 60) % 24)
let minutes = Math.floor(diff / (1000 * 60) % 60)
let seconds = Math.floor(diff / 1000 % 60)
let milliseconds = diff % 1000
countdown.innerHTML = `{formatNumber(hours)}:{formatNumber(minutes)}:{formatNumber(seconds)}:{formatNumber(milliseconds)}`
deadline.setMilliseconds(milliseconds + 20) // 每隔20毫秒更新一次倒计时显示
}
}
function formatNumber(num) {
if (num < 10) {
return `0${num}`
} else {
return num.toString()
}
}
let intervalID = setInterval(updateCountdown, 20)
在上面的代码中，我们首先定义了一个截止日期(deadline)和一个用于显示剩余时间的HTML元素(countdown)。然后，我们定义了一个名为updateCountdown()的函数，用于计算剩余时间，并更新倒计时显示。在这个函数中，我们首先使用new Date()创建一个当前时间(now)的Date对象，然后计算距离截止日期剩余的时间差(diff)。接着，我们通过数学计算，将diff转化成了一个小时、分钟、秒和毫秒的数值，并调用formatNumber()函数，将这些数值格式化成合适的形式。最后，我们使用setMilliseconds()方法，将deadline的毫秒数改为比原来多20毫秒，并将更新后的倒计时时间显示在HTML元素的innerText中。
在主函数中，我们使用setInterval()函数来每隔20毫秒调用一次updateCountdown()函数，并将返回的intervalID存储在变量中，以便稍后使用clearInterval()函数在倒计时结束时清除。
结论
setMilliseconds()方法是Date对象的一个非常有用的API，它允许开发者按照毫秒级别精确控制时间的变化。在实际开发中，它可以用于实现诸如倒计时、动画效果等与时间相关的功能。在使用该方法时，需要注意的是它只能改变Date对象的毫秒数，而其他时间部分并不会被改变，因此使用前需要仔细考虑其影响。