JavaScript / コードを試す
Date — 作る・比べる・差を出す
Date が持っているのは 1970 年からのミリ秒だけです。比較が動く理由、差が引き算で出る理由、月を足すと 1/31 が 3/3 になる理由、壊れた日付の見分け方までを実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
Date が持っているのは、1970年1月1日(協定世界時)からのミリ秒、それだけです。
const date = new Date('2026-09-08T12:34:56Z'); console.log(date.getTime()); console.log(Number(date)); console.log(date.toISOString());
1788870896000 1788870896000 2026-09-08T12:34:56.000Z
年・月・日は、その数から計算して取り出しています。持っているわけではありません。
この1点を押さえると、以下がすべて説明できます。
比べられる
const a = new Date('2026-09-01T00:00:00Z'); const b = new Date('2026-09-08T00:00:00Z'); console.log(a < b); console.log(a > b);
true false
< と > は数値に変換してから比べるので、そのまま使えます。
ですが === は使えません。
const a = new Date('2026-09-01T00:00:00Z');
const b = new Date('2026-09-01T00:00:00Z');
console.log(a === b);false
=== はオブジェクトを同じ実体かで比べます。中身は見ません。
→ 2つの配列を比べる
同じ時刻かどうかは、数にしてから比べます。
const a = new Date('2026-09-01T00:00:00Z'); const b = new Date('2026-09-01T00:00:00Z'); console.log(a.getTime() === b.getTime());
true
差は引き算で出る
const a = new Date('2026-09-01T00:00:00Z'); const b = new Date('2026-09-08T00:00:00Z'); console.log(b - a); console.log((b - a) / 86400000);
604800000 7
引き算をすると数値に変換されるので、差はミリ秒で出ます。
86400000 は1日のミリ秒数(24 * 60 * 60 * 1000)です。
ただし「1日 = 86400000ミリ秒」が常に成り立つとは限りません。 夏時間のある地域では、1日が23時間や25時間になる日があります。 日数を数えるなら、日付だけを取り出して比べるほうが確実です。
月を足すと日付が飛ぶ
いちばん危ない挙動です。
const date = new Date('2026-01-31T00:00:00Z');
date.setUTCMonth(date.getUTCMonth() + 1);
console.log(date.toISOString().slice(0, 10));2026-03-03
2月ではなく3月3日になりました。
setUTCMonth(1) は「2月31日」を作ろうとします。2月は28日までなので、
あふれた3日分が3月に繰り越されます。
月末を扱うときは、日を先に1へ寄せてから月を動かしてください。
function addMonths(date, months) { const next = new Date(date); next.setUTCDate(1); next.setUTCMonth(next.getUTCMonth() + months); return next; } console.log(addMonths(new Date('2026-01-31T00:00:00Z'), 1).toISOString().slice(0, 10));
2026-02-01
「1か月後」が何を意味するかは、仕様として決めないと書けません。 月末の翌月は末日なのか、1日なのか。先に決めてください。
日を足すのは安全
const date = new Date('2026-01-31T00:00:00Z'); const plus7 = new Date(date.getTime() + 7 * 86400000); console.log(plus7.toISOString().slice(0, 10));
2026-02-07
ミリ秒を足すだけなので、桁あふれは起きません。
壊れた日付
const bad = new Date('きのう'); console.log(String(bad)); console.log(Number.isNaN(bad.getTime()));
Invalid Date true
例外は出ません。 Invalid Date という日付になります。
このあとの計算は全部 NaN になり、書式化しようとした時点で落ちます。
const bad = new Date('きのう'); try { bad.toISOString(); } catch (error) { console.log(error.name + ': ' + error.message); }
RangeError: Invalid time value
受け取った文字列から作ったら、必ず確かめてください。
function parseDate(text) { const date = new Date(text); return Number.isNaN(date.getTime()) ? null : date; } console.log(parseDate('2026-09-08')?.toISOString() ?? '読めません'); console.log(parseDate('きのう')?.toISOString() ?? '読めません');
2026-09-08T00:00:00.000Z 読めません
判定は Number.isNaN(date.getTime()) だけです。
date === 'Invalid Date' のような比較は効きません。
→ なぜ NaN === NaN は false なのか
取り出すときは UTC か地域かを決める
const date = new Date('2026-09-08T12:34:56Z'); console.log(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
2026 8 8
getMonth() は0から始まります。 9月は 8 です。
getUTC* は協定世界時、get*(getFullYear() など)は実行環境の時間帯で計算します。
どちらを使うか決めないと、実行する場所で結果が変わります。
表示は Intl に任せるのが確実です。
→ 日付を「2026-09-08」や「2026年9月8日」に整形する
いま何時か
new Date() は実行した瞬間を持ちます。
const now = new Date();このページのコード例は掲載してある出力と突き合わせているので、実行のたびに変わるものは載せていません。上は形だけです。
まとめ
- 中身は1970年からのミリ秒だけ。年月日は計算して取り出している
<>は使える。===は使えない(getTime()で比べる)- 差は引き算でミリ秒。ただし1日が24時間でない日がある
- 月を足すと桁があふれる。
1/31の1か月後は3/3 - 日を足すのはミリ秒なので安全
- 壊れた日付は例外にならない。
Number.isNaN(date.getTime())で見る getMonth()は0始まり。getUTC*とget*を混ぜない