Date.parse()
============

**`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 Language Specification # sec-date.parse |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

### 互換性ノート

* 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 日と解釈されるからです。
関連情報
----

* `Date.UTC()`