予約の時間

JavaScriptには、日時を保持し、その管理のためのメソッドを提供する組み込みオブジェクトDateがあります。

作成

Dateオブジェクトは、Dateクラスのインスタンスです。 コンストラクター関数に引数を渡さずに作成することもできます。 こうすると、現在の日時を表すDateオブジェクトが得られます。

const now = new Date();
// => Thu Apr 14 2022 11:46:08 GMT+0530 (India Standard Time)
// Shows current day, date and time (in your time zone).

Unixタイムスタンプ（数値）

数値を渡すと、それはtimestampとして解釈されます。 タイムスタンプは、1970年1月1日 UTC+0から経過したミリ秒数を表す整数です。

const epoch = new Date(0);
// Thu Jan 01 1970 01:00:00 GMT+0100 (Central European Standard Time)

const another = new Date(1749508766627);
// Tue Jun 10 2025 00:39:26 GMT+0200 (Central European Summer Time)

new Date(0)が「最も早い」日付オブジェクトを生成すると期待するかもしれません。しかしJavaScriptは日付をローカルのタイムゾーンに変換するため、実際にUnixエポックの値を得るのは、GMT / UTC+0のタイムゾーン付近にいる人だけです。

ISO 8601タイムスタンプ（文字列）

日付を表す文字列の値を、Dateコンストラクターに渡すことができます。 実装間で一貫している唯一の形式は、国際的に認識され標準化された、いわゆるISO 8601タイムスタンプ文字列の簡略版です。

UTCでのある時点は、次のように表されます。

YYYY-MM-DDTHH:mm:ss.mssZ
YYYYMMDDTHHmmss.mssZ

各部分は次のように置き換わります。

文字そのままのZはUTCを表します（タイムゾーンなし、夏時間なし）。

ほとんどの要素にはデフォルト値があるので、末尾の部分を省略してもかまいません。

YYYY-MM-DD

時刻はデフォルトで00:00:00.000になります。

タイムスタンプがZで終わらず、タイムゾーンのオフセットを示す+HH:mmや-HH:mmでも終わらない場合、歴史的な理由から、次のことが当てはまります。

タイムゾーンのオフセットがない場合、日付のみの形式はUTC時刻として解釈され、日付と時刻の形式はローカル時刻として解釈されます。 UTC時刻としての解釈は、ISO 8601と整合しない歴史的な仕様の誤りによるものですが、ウェブの互換性のために変更できませんでした。 詳しくはBroken Parser – A Web Reality Issueを参照してください。

Dateオブジェクト

既存のDateオブジェクトをコンストラクターの引数として使うこともできます。 こうすると、同じ日時を持つ既存のDateオブジェクトのコピーが作られます。

const t1 = new Date();
const t2 = new Date(t1);
// Values of t1 and t2 will be the same.

日付と時刻の各要素の値を個別に指定する

日付だけを表すDateは、数値を3つ渡して作成できます。 日付と時刻を表すDateは、数値を6つ渡して作成できます。

const date1 = new Date(95, 11, 17);
// Creates Date for Dec 17 1995 00:00 if your local timezone is equivalent to UTC.

const date2 = new Date(2013, 12, 5, 13, 24, 0);
// Creates Date for Jan 5 2014 13:24 if your local timezone is equivalent to UTC.

2番目の値はmonthで、1月が0から始まり、12月が11になります。

Date.parse()

日付をパースする関数Date.parseへの言及や参照を見かけることがあるかもしれません。 この関数には不変の性質（常に成り立つこと）がわずかしかなく、残りの実装は仕様で定められていない（したがって標準ではない）ため、使うべきではありません。

Dateの要素にアクセスする

Dateオブジェクトには、日付の要素を返すさまざまなメソッドがあります。

getFullYear(); // Get the year (4 digits)
getMonth(); // Get the month, from 0 to 11.
getDate(); // Get the day of month, from 1 to 31.
getHours(); // Get the hour in a 24 clock, from 0 to 23
getMinutes(); // Get the minutes, from 0 to 59
getSeconds(); // Get the seconds, from 0 to 59
getMilliseconds(); // Get the milliseconds, from 0 and 999
getDay(); // Get the day of week, from 0 (Sunday) to 6 (Saturday).

これらのそれぞれには、値を更新するための対応するset版（例：setFullYear）があります。 あふれた値は、次の要素に繰り越されます。

const date = new Date('2025-02-28T12:42:00Z');
// => Fri Feb 28 2025 13:42:00 GMT+0100 (Central European Standard Time)

date.setDate(29);
// there was no February 29th in 2025.

date.getDate();
// => 1

date.toString();
// => Sat Mar 01 2025 13:42:00 GMT+0100 (Central European Standard Time)

すべてのメソッドには、ローカルのタイムゾーンを無視するUTC版があります。

日付からの変換

Dateオブジェクトには、UNIXタイムスタンプをミリ秒で返すメソッドgetTime()があります。つまり、1970年1月1日UTCの午前0時からのミリ秒数です。 さらに、DateオブジェクトをISO 8601タイムスタンプ文字列に変換するメソッドtoISOString()も利用できます。

Dateの比較

より大きい（>）と以上（>=）、およびより小さい（<）と以下（<=）は、2つのDateの間、またはDateと数値の間で直接使えます。 これは、JavaScriptがDateをプリミティブに変換しようとするために機能します。

Dateは等価（==や===）では比較できませんが、.getTime()の結果なら比較できます。