機能

日付を表す文字列を解析し、その日付と 1970 年 1 月 1 日午前 00:00:00 との差を表すミリ秒単位の値を返します。

構文

Date.parse( datestring )

引数 datestring には、日付を特定の書式 ("Jan 5, 1996 08:47:00") で表した文字列を指定します。

解説

parse メソッドの戻り値は、指定された日付と 1970 年 1 月 1 日午前 00:00:00 との差をミリ秒単位で表す整数値です。

parse メソッドは Date オブジェクトの静的な (static) メソッドです。したがって、通常のメソッドのように Date オブジェクトのインスタンスに対して実行するのではなく、必ず Date.parse( datestring ) という形で使用します。 parse メソッドが正しく日付を解析できるようにするには、次の条件を満たした文字列を指定する必要があります。

• 日付の指定には "/" または "-" を使用できます。ただし、指定する順序は米国で一般的に使用されている形式 ("月/日/年") で記述します。
• かっこで囲まれた文字列はすべてコメントとして扱われます。かっこは入れ子になっていてもかまいません。
• カンマおよびスペース文字は、両方とも区切り文字として扱われます。区切り文字は、複数記述してもかまいません。
• 月および日の名前は 2 文字以上で指定します。2 文字で指定した名前に複数の月または日が該当する場合は、その中の最後の名前が使用されます。たとえば、月に "Ju" と指定すると、June (6 月) ではなく July (7 月) となります。
• "July 10 1995" という形式で日付を指定する場合は、年、月、日はどのような順序で指定してもかまいません。年は 2 桁でも 4 桁でも指定できます。ただし、年を 2 桁で指定できるのは 日付が 1970 年以降の場合だけです。
• 指定した日付に合わない曜日を指定した場合、曜日は無視されます。たとえば、"Tuesday November 9 1996" という文字列を指定した場合、正しい曜日は金曜日で、メソッドは曜日だけを無視して正常に実行されます。
• 米国のすべての標準タイムゾーン、および UTC と GMT に対応しています。
• 時、分、秒は省略可能です。指定する場合はコロンで区切ります。"10:"、"10:11"、 "10:11:12" という指定はすべて有効です。
• 24 時間形式で時刻を指定する場合は、12 時以降の時刻に "PM" を指定するとエラーが発生します。たとえば、"23:15 PM" と指定するとエラーが発生します。
• 無効な日付の入った文字列を指定するとエラーが発生します。たとえば、年が 2 つ指定されている、月が 2 つ指定されているなどの文字列を指定するとエラーが発生します。