このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

日付と時刻の表現

メモ: Date オブジェクトは、古いものと見なされ、新しいコードでは使用を避けるべきと考えられています。近いうちに、このページを現行の代替手段について更新する予定です。

Date オブジェクト

JavaScript には日付のためのデータ型がありません。しかし、アプリケーション内で日付を取り扱うための Date オブジェクトとそのメソッドが利用できます。 Date オブジェクトは日付の設定、取得、操作を行う多数のメソッドを有しています。このオブジェクトはいかなるプロパティも持ちません。

JavaScript は Java と同じように日付を取り扱います。2 つの言語は同様の日付用メソッドを多く持ち、両方の言語とも、Unix タイムスタンプが 1970 年 1 月 1 日 00:00:00 からの秒の数値であるのと同様に、1970 年 1 月 1 日 00:00:00 からのミリ秒の数値で日付を格納しています。 1970 年 1 月 1 日の深夜午前 0 時、UTCは元期と呼ばれます。

Date オブジェクトの設定可能範囲は、元期に対し -100,000,000 日から 100,000,000 日までです。

Date オブジェクトは次のように作成します。

js
const dateObjectName = new Date([parameters]);

ここで dateObjectName は生成される Date オブジェクトの名前です。新しいオブジェクトか、あるいは既存のオブジェクトのプロパティにすることができます。

new キーワードなしで Date を呼び出すと、単に現在の日付と時間を文字列表現にしたものを返します。

上記構文の parameters は以下のいずれかになります。

  • 引数なし: 現在の日時を生成します。例えば、today = new Date(); です。
  • 日付を表す文字列で、さまざまな形式があります。対応する正確な形式はエンジンによって異なりますが、 YYYY-MM-DDTHH:mm:ss.sssZ という形式はどれもに対応しています。例えば、xmas95 = new Date("1995-12-25") です。時、分、秒を省略した場合は、それらの値がゼロに設定されます。
  • 年、月、日に対応する整数の集合。例えば、 xmas95 = new Date(1995, 11, 25) です。
  • 年、月、日、時、分、秒に対応する整数の集合。例えば、 xmas95 = new Date(1995, 11, 25, 9, 30, 0); です。