Date.parse()

dateString

文字列で、日時文字列形式です。さまざまな書式を使用する場合の注意事項については、リンク先の参照をご覧ください。

指定された日時のタイムスタンプを表す数値。 dateString が有効な日時として解釈できない場合、NaN が返されます。

この関数は、 setTime() メソッドと組み合わせて、文字列値に基づいて日時の値を設定する場合などに便利です。

parse() が処理できる書式は明示的に指定されていませんが、いくつかの不変条件があります。

• 日時文字列の書式（toISOString() によって生成される）に対応している必要があります。
• x がミリ秒の値が 0 の日付である場合、 x.valueOf() は、Date.parse(x.toString())、Date.parse(x.toUTCString())、Date.parse(x.toISOString()) のいずれかと同じでなければなりません。これは、 toString() および toUTCString() によって生成される書式も対応している必要があるということです。
• 仕様上は、 toLocaleString() によって生成される書式化に対応することは要求されていません。ただし、主要なエンジンはすべて toLocaleString("en-US") による書式化に対応しようとしています。

その他の書式は実装によって定義されており、すべてのブラウザーで動作するとは限りません。さまざまな書式に対応する必要がある場合は、ライブラリーが役立ちます。実際、Date.parse() の信頼性の低さが、 Temporal API が導入された理由のひとつです。

parse() は Date の静的メソッドであるため、作成した Date オブジェクトのメソッドとしてではなく、常に Date.parse() として使用します。

以下の呼び出しはすべて 1546300800000 を返します。最初のものは ES5 によれば UTC 時刻を意味し、それ以外は ISO 日付仕様 (Z および +00:00) に従って UTC をタイムゾーンを指定しています。

Date.parse("2019-01-01");
Date.parse("2019-01-01T00:00:00.000Z");
Date.parse("2019-01-01T00:00:00.000+00:00");

以下の呼び出しではタイムゾーンを指定していないので、システムの地方時で 2019-01-01 の 00:00:00 に設定されます。

Date.parse("2019-01-01T00:00:00");

標準の日付時刻文字列の書式化とは別に、 toString() および toUTCString() の書式化にも対応しています。

// toString() 形式
Date.parse("Thu Jan 01 1970 00:00:00 GMT-0500 (Eastern Standard Time)");
// すべての実装で、すべてのタイムゾーンにおける 18000000

// toUTCString() 形式
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");
// すべての実装で、すべてのタイムゾーンにおける 0

実装では通常、日付文字列が標準ではない場合、既定で地方時が使用されます。一貫性を保つため、ここでは、実行時が UTC タイムゾーンを使用すると想定し、特に指定がない限り、出力は端末のタイムゾーンによって異なるものとします。地方時の夏時間 (DST) も、これに影響を与える可能性があります。

標準外の日付文字列の例をいくつか挙げます。ブラウザーは日付文字列の解析にとても寛容で、解析できない文字列の部分は破棄する場合があります。互換性の理由から、ブラウザーは互いの動作をコピーすることが多いため、このような処理パターンはブラウザー間で広まる傾向があります。前述のように、次の例はあくまで説明のためのものであり、決して網羅的なものではありません。

• Date.UTC()