Date() コンストラクター
JavaScript の Date
インスタンスを生成し、これはプラットフォームに依存しない形式で単一の瞬間の時刻を表現します。 Date
オブジェクトは 1970 年 1 月 1 日 (UTC) からの経過ミリ秒数を Number
で保持します。
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
構文
new Date() new Date(value) new Date(dateString) new Date(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]])
注: 新しい Date
オブジェクトをインスタンス化する唯一の正しい方法は、 new
演算子を使用することです。単純に直接 Date
オブジェクトを now = Date()
のように呼び出すと、返値は Date
オブジェクトではなく文字列になります。
引数
Date()
コンストラクターには4つの基本形があります。
-
引数なし
引数が与えられなかった場合は、新しく生成された
Date
オブジェクトはインスタンス化された時点で現在の日付と時刻を表します。 -
時刻値またはタイムスタンプ値
value
- 世界協定時 (UTC) 1970年1月1日午前0時0分0秒 (ECMAScript 元期、 UNIX 元期と等価) からのミリ秒数を整数値で表し、うるう秒は無視します。大部分の UNIX Timestamp 関数は秒単位の精度しかないことに注意してください。
-
タイムスタンプ文字列
dateString
- 日付を表す文字列値で、
Date.parse()
メソッドによって認識される形式で指定されます。 (これらの形式は IETF 準拠の RFC 2822 タイムスタンプであり、 ISO8601 のバージョンの文字列でもあります。)注:
Date
コンストラクター (および同じように動作するDate.parse()
) を使用した日付文字列の解析は、ブラウザーによって違いや矛盾があるため、使用を避けることを強くお勧めします。。- RFC 2822 書式の文字列の対応は慣習的に行われているだけです。
- ISO 8601 形式の対応は、日付のみの文字列 (例えば
1970-01-01
) が地方時ではなく UTC として扱われる点が異なります。
-
独立した日付と時刻の成分の値
少なくとも年と月が指定された場合、この形の
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) を表す整数値です。
例
Date オブジェクトを生成するいくつかの方法
以下の例で、JavaScript の Date を生成するいくつかの方法を示します。
注: 日付文字列を Date
コンストラクター (または同等の Date.parse
) で解釈する方法は、ブラウザーごとに動作が異なり一貫性がないため、避けることを強くおすすめします。
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)
仕様書
ブラウザーの互換性
BCD tables only load in the browser