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() 方法将当前日期的“毫秒”设置为 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”作为下一秒的第一毫秒。

打印页面