Date.prototype.setTime()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
setTime() は Date インスタンスのメソッドで、この日付のタイムスタンプを変更します。これは、 UTC の 1970 年 1 月 1 日午前 0 時を元期として定義される、元期からのミリ秒数です。
試してみましょう
const launchDate = new Date("July 1, 1999, 12:00:00");
const futureDate = new Date();
futureDate.setTime(launchDate.getTime());
console.log(futureDate);
// 予想される結果: "Thu Jul 01 1999 12:00:00 GMT+0200 (CEST)"
const fiveMinutesInMs = 5 * 60 * 1000;
futureDate.setTime(futureDate.getTime() + fiveMinutesInMs);
console.log(futureDate);
// 予想される結果: "Thu Jul 01 1999 12:05:00 GMT+0200 (CEST)"
// メモ: 時間帯は変更されることがあります。
構文
js
setTime(timeValue)
引数
timeValue-
新しいタイムスタンプを表す整数で、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からのミリ秒数です。
返値
その場で Date オブジェクトを変更し、新しいタイムスタンプを返します。 timeValue が NaN （または undefined など、 NaN に変換されるその他の値）の場合、日付は無効な日時に設定され、 NaN が返されます。
例
setTime() の使用
js
const theBigDay = new Date("1999-07-01");
const sameAsBigDay = new Date();
sameAsBigDay.setTime(theBigDay.getTime());
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-date.prototype.settime |