Date() コンストラクター

JavaScript の Date インスタンスを生成し、これはプラットフォームに依存しない形式で単一の瞬間の時刻を表現します。 Date オブジェクトは 1970 年 1 月 1 日 (UTC) からの経過ミリ秒数を Number で保持します。

new Date()
new Date(value)
new Date(dateString)
new Date(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]])

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

1. 引数なし

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

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

   value

   世界協定時 (UTC) 1970年1月1日午前0時0分0秒 (ECMAScript 元期、 UNIX 元期と等価) からのミリ秒数を整数値で表し、うるう秒は無視します。大部分の UNIX Timestamp 関数は秒単位の精度しかないことに注意してください。

3. タイムスタンプ文字列

   dateString

   日付を表す文字列値で、 Date.parse() メソッドによって認識される形式で指定されます。 (これらの形式は IETF 準拠の RFC 2822 タイムスタンプであり、 ISO8601 のバージョンの文字列でもあります。)

   注: Date コンストラクター (および同じように動作する Date.parse()) を使用した日付文字列の解析は、ブラウザーによって違いや矛盾があるため、使用を避けることを強くお勧めします。。

   • RFC 2822 書式の文字列の対応は慣習的に行われているだけです。
   • ISO 8601 形式の対応は、日付のみの文字列 (例えば 1970-01-01) が地方時ではなく UTC として扱われる点が異なります。

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

   少なくとも年と月が指定された場合、この形の Date() は成分の値 (年、月、日、時、分、秒、ミリ秒) のすべてを以下の引数から取得した Date オブジェクトを返します。欠けている値は、有効な最も小さな値 (day では 1、他の成分では 0) になります。

   year

   年を表す整数値です。

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

   monthIndex

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

   day 省略可

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

   hours 省略可

   1日の中の時を表します。既定値は 0 です。

   minutes 省略可

   任意。分 (0-59) を表す整数値です。

   seconds 省略可

   任意。秒 (0-59) を表す整数値です。

   milliseconds 省略可

   任意。ミリ秒 (0-999) を表す整数値です。

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

let today = new Date()
let birthday = new Date('December 17, 1995 03:24:00')
let birthday = new Date('1995-12-17T03:24:00')
let birthday = new Date(1995, 11, 17)            // the month is 0-indexed
let birthday = new Date(1995, 11, 17, 3, 24, 0)

• Date