← 返回首页
Date.prototype.setTime() - JavaScript | MDN

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

関連情報