Date.prototype.setUTCMilliseconds()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

setUTCMilliseconds()Date インスタンスのメソッドで、協定世界時に基づき、指定された日時の「ミリ秒」を設定します。

試してみましょう

const date1 = new Date("2018-01-24T12:38:29.069Z");

console.log(date1.getUTCMilliseconds());
// 予想される結果: 69

date1.setUTCMilliseconds(420);

console.log(date1.getUTCMilliseconds());
// 予想される結果: 420

構文

js
setUTCMilliseconds(millisecondsValue)

引数

millisecondsValue

「ミリ秒」を表す 0 から 999 までの間の整数値。

返値

その場で Date オブジェクトを変更し、新しいタイムスタンプを返します。 millisecondsValueNaN (または undefined など、 NaN変換されるその他の値)の場合、日付は無効な日時に設定され、 NaN が返されます。

解説

指定した値が期待される日付の範囲外の場合、それに応じて setUTCMilliseconds()Date オブジェクトの日付情報の更新を試みます。例えば、millisecondsValue に 1100 を指定した場合、Date オブジェクトに格納された秒の数値に 1 が加算され、ミリ秒に 100 が使用されます。

setUTCMilliseconds() の使用

js
const theBigDay = new Date();
theBigDay.setUTCMilliseconds(500);

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.setutcmilliseconds

ブラウザーの互換性

関連情報