JavaScript Date setMilliseconds() 方法

JavaScript Date.setMilliseconds() 方法用于设置日期对象的"毫秒数"。毫秒值的范围是 0 到 999。该方法返回设置毫秒部分后，日期对象当前时间与 1970 年 1 月 1 日午夜之间的毫秒数。

如果提供的日期对象"无效"，则此方法返回非数字 (NaN) 作为结果。此方法修改日期对象的毫秒部分，而不更改其他日期部分。

语法

以下是 JavaScript Date setMilliseconds() 方法的语法 -

setMilliseconds(millisecondsValue);

参数

此方法仅接受一个参数。如下所示:-

• millisecondsValue - 表示毫秒的整数(0 到 999)。
  • 如果提供 -1，则返回前一秒的最后一毫秒。
  • 如果提供 1000，则返回下一秒的第一毫秒。

返回值

此方法不返回新的日期对象。相反，它会通过将毫秒组件设置为指定值来修改现有的 Date 对象。

示例 1

在下面的示例中，我们使用 JavaScript Date 的 setMilliseconds() 方法将当前 Date 的"毫秒"设置为 500 −

<html>
<body>
<script>
   const myDate = new Date();
   myDate.setMilliseconds(500);

   document.write(myDate.getMilliseconds());
</script>
</body>
</html>

输出

如果我们执行上述程序，毫秒数将被设置为 500。

示例 2

在这里，我们将当前日期加 300000 毫秒 -

<html>
<body>
<script>
   const currentDate = new Date();
   const millisecondsToAdd = 300000; // Add 5 minutes (300000 milliseconds)

   currentDate.setMilliseconds(currentDate.getMilliseconds() + millisecondsToAdd);

   document.write(currentDate);
</script>
</body>
</html>

输出

上述程序将在当前日期上添加 5 分钟。

示例 3

如果我们为 millisecondsValue 提供"-1"，则此方法将返回前一秒的最后一毫秒 -

<html>
<body>
<script>
   const myDate = new Date();
   myDate.setMilliseconds(-1);

   document.write(myDate.getMilliseconds());
</script>
</body>
</html>

输出

此方法返回"999"作为前一秒的最后一毫秒。

示例 4

如果我们为 millisecondsValue 提供"1000"，此方法将返回下一秒的第一毫秒 -

<html>
<body>
<script>
   const myDate = new Date();
   myDate.setMilliseconds(1000);

   document.write(myDate.getMilliseconds());
</script>
</body>
</html>

输出

此方法返回"0"作为下一秒的第一毫秒。