Date.parse()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Date.parse() メソッドは、日時を表す文字列を解釈し、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からの経過時間を表すミリ秒単位の数値を返します。または、文字列を解釈できなかったり不正な日付(例えば 2015-02-31)が指定されたりした場合は NaN を返します。

対応するよう明示的に指定されているのは ISO 8601 形式 (YYYY-MM-DDTHH:mm:ss.sssZ) のみです。他の形式は実装で定義されており、すべてのブラウザーで動作するとは限りません。多くの様々な形式に対応するためには、ライブラリーが役に立ちます。

試してみましょう

構文

js
Date.parse(dateString)

引数

dateString

文字列で、ISO 8601 カレンダー日付拡張形式の簡略化されたものを表します。 (その他の形式も使用することができますが、結果は実装依存になります。)

返値

協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 UTC からの経過時間をミリ秒単位で表す数値。このメソッドに与えられた日付を表す文字列の解釈により取得される日付。引数に正しい値が与えられなかった場合、 NaN を返します。

解説

parse() メソッドは、日時の文字列(例えば "2011-10-10T14:48:00")を取り、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からのミリ秒単位の経過時間を表す数値を返します。

この関数は、例えば setTime() メソッドと Date オブジェクトを組み合わせて使う場合など、文字列値を基にして日時の値を設定するときに便利です。

日付と時刻の文字列書式

日時文字列の標準的な文字列表現は、 ISO 8601 のカレンダー日付拡張形式を簡略化したものです。(詳しくは、 ECMAScript 仕様書の Date Time String Format の章を参照してください。)

例えば、 "2011-10-10"日付のみの形式)、"2011-10-10T14:48:00"日時形式)、"2011-10-10T14:48:00.000+09:00"日時形式にミリ秒とタイムゾーンがついたもの)を渡し、解釈することができます。タイムゾーンのオフセットがない場合は、日付のみの形式では UTC 時刻と解釈され、日時形式では地方時として解釈されます。

タイムゾーン指定子は、日付文字列の解析中に引数を解釈するために使用されますが、返される値は常に、 1970 年 1 月 1 日 00:00:00 UTC と、引数で表される時点との間のミリ秒数または NaN です。

parse()Date の静的メソッドですので、 Date インスタンスのメソッドとしてではなく Date.parse() として呼び出されます。

実装依存の日付形式へのフォールバック

メモ: この節では実装依存の動作を説明しており、実装間で一貫性がない可能性があります。

ECMAScript 仕様書は、文字列が標準の書式に準拠していない場合、この関数は実装固有の検出方法や実装固有の解析アルゴリズムにフォールバックすることがあり、解釈できない文字列や ISO 書式文字列における不正な要素値を含む日付を渡すと、 Date.parse()NaN を返すと規定しています。

しかし、 ECMA-262 で定義されている簡略化 ISO 書式として解釈できない日付文字列の無効な値は、ブラウザーや与えられた値に依存して、 NaN を返したり返さなかったりすることがあります。次の例を参照してください。

js
// 不正な値を持つ 非 ISO 文字列
new Date("23/25/2014");

これは、 Firefox 30 では、地方時の 2015 年 11 月 25 日として扱われ、 Safari 7 では不正な値として処理されます。

しかし、文字列が ISO 書式の文字列として解釈され、不正な値を含む場合、 ES5 以降の仕様に準拠するすべてのブラウザーが NaN を返します。

js
// 不正な値を持つ ISO 文字列
new Date("2014-25-23").toISOString();
// ES5 準拠のすべてのブラウザーが "RangeError: invalid date" を返す

SpiderMonkey の実装特有のヒューリスティックは、jsdate.cpp にあります。 "10 06 2014" の文字列は、非 ISO 書式の例として挙げられており、このようにカスタム処理にフォールバックされます。この解釈の動作を説明するおよそのアウトライン も参照してください。

js
new Date("10 06 2014");

これは、2014 年 6 月 10 日ではなく、地方時の 2014 年 10 月 6 日 として扱われます。

他の例です。

js
new Date("foo-bar 2014").toString();
// 返値: "Invalid Date"

Date.parse("foo-bar 2014");
// 返値: NaN

想定されるタイムゾーンの違い

メモ: この節では実装依存の動作を説明しており、実装間で一貫性がない可能性があります。

標準外の日付文字列である "March 7, 2014" を渡すと、 parse() はタイムゾーンとして地方時を想定しますが、 "2014-03-07" のような ISO 書式を与えると UTC をタイムゾーンとして想定します (ES5 および ECMAScript 2015 の仕様)。したがって、これらの文字列を使用して生成される Date オブジェクトは、システムが UTC の地方時に設定されていない限り、対応している ECMAScript のバージョンによって異なる時刻を表す可能性があります。つまり、同じように見える 2 つの日付文字列が、変換される文字列の形式によって 2 つの異なる値になる可能性があるということです。

Date.parse() の使用

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

js
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 に設定されます。

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

標準外の日付文字列

メモ: この節では実装依存の動作を説明しており、実装間で一貫性がない可能性があります。

IPOdate が既存の Date オブジェクトならば、次のようにして、これを 1995 年 8 月 9 日 (地方時) にセットできます:

js
IPOdate.setTime(Date.parse("Aug 9, 1995"));

それ以外の標準外の日付文字列の解釈の例を示します。

js
Date.parse("Aug 9, 1995");

GMT-0300 のタイムゾーンでは 807937200000 を返し、他のタイムゾーンでは他の値を返します。タイムゾーンが指定されておらず ISO 書式でないため、既定で地方時のタイムゾーンが使用されます。

js
Date.parse("Wed, 09 Aug 1995 00:00:00 GMT");

GMT (UTC) が指定されているため、地方時のタイムゾーンに関係なく 807926400000 を返します。

js
Date.parse("Wed, 09 Aug 1995 00:00:00");

GMT-0300 のタイムゾーンでは 807937200000 を返し、他のタイムゾーンでは他の値を返します。引数にタイムゾーンが指定されておらず、 ISO 書式ではないため、地方時として扱われます。

js
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");

GMT (UTC) のタイムゾーンが指定されているため、地方時のタイムゾーンに関係なく 0 を返します。

js
Date.parse("Thu, 01 Jan 1970 00:00:00");

GMT-0400 のタイムゾーンでは 14400000 を返し、他のタイムゾーンでは他の値を返します。タイムゾーンが指定されておらず、 ISO 書式ではないため、地方時のタイムゾーンが使用されます。

js
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT-0400");

GMT (UTC) のタイムゾーンが指定されているため、地方時のタイムゾーンに関係なく 14400000 を返します。

仕様書

Specification
ECMAScript® 2025 Language Specification
# sec-date.parse

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
parse
ISO 8601 format

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

互換性ノート

  • Firefox 49 で、2 桁の「年」の解釈が、 Internet Explorer に代わって Google Chrome ブラウザーに準拠するように変更されました。現在、 50 以下の 2 桁の「年」は 21 世紀の年として解釈されます。例えば 04/16/17 は、以前は 1917 年 4 月 16 日と解釈されていましたが、 2017 年 4 月 16 日と解釈されるようになりました。相互運用性の問題や年があいまいになることを回避するには、 ISO 8601 書式 ("2017-04-16" など) の使用が推奨されます (bug 1265136)。
  • Google Chrome は数値の文字列を有効な dateString 引数として受け付けます。これは、すなわち、 !!Date.parse("42") は Firefox では false として評価されるのに対して、 Google Chrome では true として評価されます。 "42" は 2042 年 1 月 1 日と解釈されるからです。

関連情報