本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

Date — 作る・比べる・差を出す

Date が持っているのは 1970 年からのミリ秒だけです。比較が動く理由、差が引き算で出る理由、月を足すと 1/31 が 3/3 になる理由、壊れた日付の見分け方までを実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

Date が持っているのは、1970年1月1日(協定世界時)からのミリ秒、それだけです。

example.js

const date = new Date('2026-09-08T12:34:56Z');

console.log(date.getTime());
console.log(Number(date));
console.log(date.toISOString());
固定例の期待出力 · Node 24.22.3
1788870896000
1788870896000
2026-09-08T12:34:56.000Z
表示用コードUTF-8 · LF

年・月・日は、その数から計算して取り出しています。持っているわけではありません。

この1点を押さえると、以下がすべて説明できます。

比べられる

example.js

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);
固定例の期待出力 · Node 24.22.3
true
false
表示用コードUTF-8 · LF

< と > は数値に変換してから比べるので、そのまま使えます。

ですが === は使えません。

javascript失敗・注意の例

const a = new Date('2026-09-01T00:00:00Z');
const b = new Date('2026-09-01T00:00:00Z');

console.log(a === b);
固定例の期待出力 · Node 24.22.3
false
表示用コードUTF-8 · LF

=== はオブジェクトを同じ実体かで比べます。中身は見ません。 → 2つの配列を比べる

同じ時刻かどうかは、数にしてから比べます。

example.js

const a = new Date('2026-09-01T00:00:00Z');
const b = new Date('2026-09-01T00:00:00Z');

console.log(a.getTime() === b.getTime());
固定例の期待出力 · Node 24.22.3
true
表示用コードUTF-8 · LF

差は引き算で出る

example.js

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);
固定例の期待出力 · Node 24.22.3
604800000
7
表示用コードUTF-8 · LF

引き算をすると数値に変換されるので、差はミリ秒で出ます。 86400000 は1日のミリ秒数(24 * 60 * 60 * 1000)です。

ただし「1日 = 86400000ミリ秒」が常に成り立つとは限りません。 夏時間のある地域では、1日が23時間や25時間になる日があります。 日数を数えるなら、日付だけを取り出して比べるほうが確実です。

月を足すと日付が飛ぶ

いちばん危ない挙動です。

javascript失敗・注意の例

const date = new Date('2026-01-31T00:00:00Z');

date.setUTCMonth(date.getUTCMonth() + 1);

console.log(date.toISOString().slice(0, 10));
固定例の期待出力 · Node 24.22.3
2026-03-03
表示用コードUTF-8 · LF

2月ではなく3月3日になりました。

setUTCMonth(1) は「2月31日」を作ろうとします。2月は28日までなので、 あふれた3日分が3月に繰り越されます。

月末を扱うときは、日を先に1へ寄せてから月を動かしてください。

example.js

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));
固定例の期待出力 · Node 24.22.3
2026-02-01
表示用コードUTF-8 · LF

「1か月後」が何を意味するかは、仕様として決めないと書けません。 月末の翌月は末日なのか、1日なのか。先に決めてください。

日を足すのは安全

example.js

const date = new Date('2026-01-31T00:00:00Z');
const plus7 = new Date(date.getTime() + 7 * 86400000);

console.log(plus7.toISOString().slice(0, 10));
固定例の期待出力 · Node 24.22.3
2026-02-07
表示用コードUTF-8 · LF

ミリ秒を足すだけなので、桁あふれは起きません。

壊れた日付

example.js

const bad = new Date('きのう');

console.log(String(bad));
console.log(Number.isNaN(bad.getTime()));
固定例の期待出力 · Node 24.22.3
Invalid Date
true
表示用コードUTF-8 · LF

例外は出ません。 Invalid Date という日付になります。

このあとの計算は全部 NaN になり、書式化しようとした時点で落ちます。

example.js

const bad = new Date('きのう');

try {
  bad.toISOString();
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
RangeError: Invalid time value
表示用コードUTF-8 · LF

受け取った文字列から作ったら、必ず確かめてください。

example.js

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() ?? '読めません');
固定例の期待出力 · Node 24.22.3
2026-09-08T00:00:00.000Z
読めません
表示用コードUTF-8 · LF

判定は Number.isNaN(date.getTime()) だけです。 date === 'Invalid Date' のような比較は効きません。 → なぜ NaN === NaN は false なのか

取り出すときは UTC か地域かを決める

example.js

const date = new Date('2026-09-08T12:34:56Z');

console.log(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
固定例の期待出力 · Node 24.22.3
2026 8 8
表示用コードUTF-8 · LF

getMonth() は0から始まります。 9月は 8 です。

getUTC* は協定世界時、get*(getFullYear() など)は実行環境の時間帯で計算します。 どちらを使うか決めないと、実行する場所で結果が変わります。

表示は Intl に任せるのが確実です。 → 日付を「2026-09-08」や「2026年9月8日」に整形する

いま何時か

new Date() は実行した瞬間を持ちます。

javascript
const now = new Date();
表示用コードUTF-8 · LF

このページのコード例は掲載してある出力と突き合わせているので、実行のたびに変わるものは載せていません。上は形だけです。

まとめ

  • 中身は1970年からのミリ秒だけ。年月日は計算して取り出している
  • < > は使える。=== は使えない(getTime() で比べる)
  • 差は引き算でミリ秒。ただし1日が24時間でない日がある
  • 月を足すと桁があふれる。 1/31 の1か月後は 3/3
  • 日を足すのはミリ秒なので安全
  • 壊れた日付は例外にならない。Number.isNaN(date.getTime()) で見る
  • getMonth() は0始まり。getUTC* と get* を混ぜない

出典

この教材の原文(Markdown・別タブ)