From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/date/gettime/index.html | 110 +++++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/date/gettime/index.html (limited to 'files/ja/web/javascript/reference/global_objects/date/gettime') diff --git a/files/ja/web/javascript/reference/global_objects/date/gettime/index.html b/files/ja/web/javascript/reference/global_objects/date/gettime/index.html new file mode 100644 index 0000000000..c0ff3ff0e1 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/gettime/index.html @@ -0,0 +1,110 @@ +--- +title: Date.prototype.getTime() +slug: Web/JavaScript/Reference/Global_Objects/Date/getTime +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getTime +--- +
{{JSRef}}
+ +

getTime() メソッドは、 UNIX 元期からの経過ミリ秒数*を返します。

+ +

* JavaScriptは測定単位としてミリ秒を使用しますが、 Unix 時間は秒単位です。

+ +

getTime() は時間表現に常に UTC を使用します。例えば、あるタイムゾーンに設定されているブラウザーの getTime() も、他のタイムゾーンに設定されたブラウザーの getTime() も、同じ値を返します。

+ +

このメソッドは、日付と時刻を別の {{jsxref("Date")}} オブジェクトへ代入する助けとして使用できます。このメソッドは、{{jsxref("Date.valueof", "valueOf()")}} メソッドと機能的に同等です。

+ +
{{EmbedInteractiveExample("pages/js/date-gettime.html","shorter")}}
+ + + +

構文

+ +
dateObj.getTime()
+ +

返値

+ +

1970 年 1 月 1 日 00:00:00 UTC から指定した日時までの経過時間をミリ秒で表した数値。

+ +

時刻の低精度化

+ +

ブラウザーの設定によっては、タイミング攻撃と Fingerprinting に対する保護を提供するために new Date().getTime() の精度が落とされていることがあります。 Firefox では、privacy.reduceTimerPrecision が既定で有効になっています。既定値は Firefox 59 では 20 マイクロ秒で、 Firefox 60 では 2 ミリ秒です。

+ +
// Firefox 60 での時刻の精度の低下（2 ミリ秒）
+new Date().getTime();
+// 1519211809934
+// 1519211810362
+// 1519211811670
+// ...
+
+
+// `privacy.resistFingerprinting` が有効な場合の時刻の精度の低下
+new Date().getTime();
+// 1519129853500
+// 1519129858900
+// 1519129864400
+// ...
+
+ +

Firefox では、 privacy.resistFingerprinting も有効にできます。この場合、精度は 100 ミリ秒と privacy.resistFingerprinting.reduceTimerPrecision.microseconds 値のうち大きい方になります。

+ +

例

+ +

getTime() を使って日付をコピーする

+ +

同一の time 値を持つ date オブジェクトを構築します。

+ +
// month は 0 を基点とするため、birthday は 1995 年 1 月 10 日になります
+var birthday = new Date(1994, 12, 10);
+var copy = new Date();
+copy.setTime(birthday.getTime());
+
+ +

実行時間を計測する

+ +

新たに生成された {{jsxref("Date")}} オブジェクトでの、続く 2 個の getTime() の結果を減算して、これらの呼び出しと呼び出しの間の時間を得ます。これは、何らかの命令の実行時間を計測するために使用できます。不要な {{jsxref("Date")}} オブジェクトのインスタンス化を避けるため、{{jsxref("Date.now()")}} も参照してください。

+ +
var end, start;
+
+start = new Date();
+for (var i = 0; i < 1000; i++) {
+  Math.sqrt(i);
+}
+end = new Date();
+
+console.log('Operation took ' + (end.getTime() - start.getTime()) + ' msec');
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("javascript.builtins.Date.getTime")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf