Date() コンストラクター

Date() コンストラクターには 5 つの基本形があります。

引数なし

引数が与えられなかった場合、新しく生成された Date オブジェクトはインスタンス化された時点の現在の日付と時刻を表します。返される日時のタイムスタンプは、 Date.now() で返される数値と同じです。

時刻値またはタイムスタンプ値

value

タイムスタンプを表す整数値（1970 年 1 月 1 日午前 0 時 (UTC) からのミリ秒数、別名、元期）。

日付文字列

dateString

Date.parse() で実装されているのと同じアルゴリズムを使用して解釈できる、日付を表す文字列値です。様々な書式を使用する場合の注意事項については、日時文字列形式を参照してください。

Date オブジェクト

dateObject

既存の Date オブジェクトです。これは、既存の Date オブジェクトのコピーを、同じ日付と時刻で効率的に作成します。これは new Date(dateObject.valueOf()) と同じですが、 valueOf() メソッドが呼び出されない点が異なります。

Date() コンストラクターに 1 つの引数が渡された場合、 Date インスタンスは特別に扱われます。他のすべての値はプリミティブに変換されます。もし結果が文字列であれば、それは日時文字列として解釈されます。そうでない場合は、結果のプリミティブはさらに数値に強制され、タイムスタンプとして扱われます。

独立した日付と時刻の成分の値

少なくとも年と月が指定された場合、この Date() の形式は Date オブジェクトを返します。その成分値（年、月、日、時、分、秒、ミリ秒）はすべて以下の引数から得られます。欠落しているフィールドには、使用可能な最小の値（day には 1、他にもすべての成分には 0 ）が指定されます。引数の値はすべて、UTC ではなくローカルのタイムゾーンに対して評価されます。 Date.UTC() は同様の引数を受け入れますが、各成分を UTC として解釈し、タイムスタンプを返します。

いずれかの引数が定義された境界を超えた場合、「繰り上げ」が行われます。例えば、 monthIndex に 11 よりも大きな値が渡された場合、その月は年を増加させます。 minutes に 59 よりも大きな値が渡された場合、hours はそれに応じて増加します。したがって、 new Date(1990, 12, 1) は 1991 年 1 月 1 日を返し、 new Date(2020, 5, 19, 25, 65) は 2020 年 6 月 20 日の午前 2 時 5 分を返します。

同様に、何か引数がアンダーフローする場合は、上位の引数を「桁借り」します。例えば、new Date(2020, 5, 0) は、 2020 年 5 月 31 日を返します。

year

年を表す整数値です。 0 から 99 までの値は、 1900 から 1999 までの値にマッピングされます。他の値は実際の年になります。例をご覧ください。

monthIndex

月を表す整数値です。 0 （1 月）から 11 （12 月）までの値です。

day 省略可

月内の日を表す整数値です。既定値は 1 です。

hours 省略可

0 から 23 までの間の整数値で、 1 日の中の時を表します。既定値は 0 です。

minutes 省略可

整数値で、時刻の分の部分を表します。既定値は 0 です。

seconds 省略可

整数値で、時刻の秒の部分を表します。既定値は 0 です。

milliseconds 省略可

整数値で、時刻のミリ秒の部分を表します。既定値は 0 です。

new Date() （Date() コンストラクター）を呼び出すと、 Date オブジェクトを返します。日時として無効な文字列、または構築される日時がタイムスタンプの -8,640,000,000,000,000 ミリ秒以前または 8,640,000,000,000,000 ミリ秒より後になる場合、無効な日時（Date オブジェクトで toString() メソッドが "Invalid Date" を返し、 valueOf() メソッドが NaN を返すもの）を返します。

Date() 関数を（new キーワードなしで）呼び出すと、 new Date().toString() と全く同じように、現在の日付と時刻を文字列で表現したものを返します。 Date() 関数を（new キーワードなしで）呼び出す際に指定された引数は無視されます。無効な日付文字列で呼び出された場合でも、あるいは、任意のオブジェクトや他のプリミティブを引数として呼び出された場合でも、常に現在の日付と時刻を文字列で表現したものを返します。

タイミング攻撃やフィンガープリンティングに対する保護機能を提供するために、 someFile.lastModified の精度がブラウザーの設定に応じて丸められることがあります。 Firefox では、privacy.reduceTimerPrecision 設定は既定で有効になっており、既定で 2 ミリ秒になります。この場合、精度は 100ms または privacy.resistFingerprinting.reduceTimerPrecision.microseconds の値のどちらか大きい方になります。

例えば、時刻の精度を下げた場合、someFile.lastModified の結果は常に 2 の倍数になり、privacy.resistFingerprinting を有効にした場合は 100 の倍数（または privacy.resistFingerprinting.reduceTimerPrecision.microseconds）になります。

// Firefox 60 での時間の制度の低下 (2ms)
someFile.lastModified;
// 取りうる値:
// 1519211809934
// 1519211810362
// 1519211811670
// …

// `privacy.resistFingerprinting` が有効な場合の時間の制度の低下
someFile.lastModified;
// 取りうる値:
// 1519129853500
// 1519129858900
// 1519129864400
// …

以下の例で、JavaScript の Date を生成するいくつかの方法を示します。

const today = new Date();
const birthday = new Date("December 17, 1995 03:24:00"); // 非推奨: すべてのランタイムで動作するとは限りません
const birthday = new Date("1995-12-17T03:24:00"); // ISO-8601 互換であり、動作に信頼性があります
const birthday = new Date(1995, 11, 17); // 月は 0 から始まります
const birthday = new Date(1995, 11, 17, 3, 24, 0);
const birthday = new Date(628021800000); // 元期のタイムスタンプを渡す

もし、 Date() コンストラクターが Date インスタンスではない 1 つの引数で呼び出された場合、プリミティブに変換された後、文字列であるかどうかがチェックされます。例えば、 new Date(undefined) は new Date() とは異なります。

console.log(new Date(undefined)); // Invalid Date

これは、 undefined は既にプリミティブであるものの、文字列ではないため、数値である NaN に変換され、タイムスタンプとして有効なものにならないからです。他にも、 null は 0 に変換されます。

console.log(new Date(null)); // 1970-01-01T00:00:00.000Z

配列は Array.prototype.toString() によって文字列に強制され、要素はカンマで結合されます。しかし、複数の要素を持つ配列の結果の文字列は、有効な ISO 8601 日付文字列ではないため、その解釈の動作は実装依存となります。 Date() コンストラクターに、配列を渡さないでください。

console.log(new Date(["2020-06-19", "17:13"]));
// Chrome では 2020-06-19T17:13:00.000Z になります。 "2020-06-19,17:13" と解釈されるからです。
// Firefox では "Invalid Date" となります。

• Date