JavaScript Dateの使い方｜日付の取得・フォーマット・比較

Dateオブジェクトは「ある一瞬」を表す

JavaScriptの Date は、ある特定の一瞬を表すオブジェクトです。内部的には、1970年1月1日UTC(いわゆる「Unixエポック」)からの経過ミリ秒数という、ただの数値でしかありません。年・月・日・タイムゾーン・フォーマットといったものは、すべてこの数値の上に被せた「見せ方」にすぎないわけです。

const now = new Date();
console.log(now);
console.log(now.getTime());

now.getTime() が返すのは、ミリ秒単位の生の数値です。Date でやること——比較する、日数を足す、フォーマットする——はすべて、この数値をいじって別の形で読み直しているだけ、と考えるとスッキリします。

このイメージは常に頭の片隅に置いておいてください。Date は「パリの3月14日」という情報を持っているわけではありません。あくまで世界共通の瞬間を表していて、それをパリのタイムゾーンで見れば3月14日、ロサンゼルスで見れば3月13日、というふうに表示が変わるだけなのです。

Date オブジェクトの作り方

Date を作る方法は、大きく分けて4つあります。

const now = new Date();
const fromTimestamp = new Date(1_700_000_000_000);
const fromString = new Date("2026-03-14T09:30:00Z");
const fromParts = new Date(2026, 2, 14, 9, 30);

console.log(now.toISOString());
console.log(fromTimestamp.toISOString());
console.log(fromString.toISOString());
console.log(fromParts.toISOString());

注目してほしいポイントが2つあります。

• 引数で指定するコンストラクタの月は0始まりです。2 は3月、1月は 0 になります。これはバグの温床になりがちですが、API全体を通して月は常に0始まりなので、少なくとも一貫性はあります。
• new Date("2026-03-14")（時刻なし）は UTCの午前0時 として解釈されます。一方、new Date("2026-03-14T09:30")（Z なし）は ローカル時刻 として解釈されます。この非対称さは、JavaScriptの日付処理でよくハマるポイントです。

「今この瞬間」を数値で取得したいなら、オブジェクト生成のコストがかからない Date.now() を使うのがおすすめです。

const start = Date.now();
for (let i = 0; i < 1_000_000; i++) {}
const elapsed = Date.now() - start;
console.log(`${elapsed} ms`);

経過時間やタイムアウトの計測など、カレンダー的な計算が不要な場面では Date.now() がベストな選択肢です。

日付から各要素を取り出す

Date オブジェクトを作ったら、あとはゲッターを使って年・月・日といった各要素を取り出します。それぞれにローカルタイム版とUTC版の2種類が用意されています。

const d = new Date("2026-03-14T09:30:00Z");

console.log(d.getFullYear());      // ローカルの年
console.log(d.getMonth());         // 0〜11、ローカル
console.log(d.getDate());          // 月内の日、ローカル
console.log(d.getDay());           // 曜日、0=日曜日
console.log(d.getHours());
console.log(d.getMinutes());

console.log(d.getUTCFullYear());
console.log(d.getUTCHours());

ローカル系のメソッドは、コードを動かしているマシンの設定に左右されます。ユーザーやサーバーをまたいで日付を保存したり比較したりするなら、必ず UTC を明示的に指定してください。さもないと、原因不明のバグを追いかけるハメになります。基本方針はシンプルで、DB やログに残す値には UTC 系のゲッター、画面に表示する値にはローカル系のゲッターを使い分けるのが鉄則です。

getYear() は使わないでください。これは 年 - 1900 を返すレガシーなメソッドで、互換性のためだけに残されています。年を取得したいときは、迷わず getFullYear() を使いましょう。

人に見せるための日付フォーマット

自分が気にする用途で date.toString() を使うのは避けてください。出力はロケールや JavaScript エンジンによって変わってしまいます。覚えておく価値があるフォーマッタは 2 つあります。

機械が読みやすい標準的な文字列が欲しいときは、toISOString() を使います。

const d = new Date("2026-03-14T09:30:00Z");
console.log(d.toISOString());

ログ出力やJSON保存、ネットワーク送信にはこの形式を使います。常にUTCで、曖昧さがありません。

ユーザー向けに表示する文字列が欲しい場合は、Intl.DateTimeFormat か、その薄いラッパーである toLocale* 系メソッドを使いましょう。

const d = new Date("2026-03-14T09:30:00Z");

console.log(d.toLocaleDateString("en-US"));
console.log(d.toLocaleDateString("en-GB"));
console.log(d.toLocaleString("fr-FR", { dateStyle: "full", timeStyle: "short" }));

const formatter = new Intl.DateTimeFormat("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "America/New_York",
});
console.log(formatter.format(d));

Intl.DateTimeFormat はロケール、タイムゾーン、そして欲しいフィールドの組み合わせを一通り面倒見てくれます。${year}-${month}-${day} のように手動で組み立てる前に、まずこちらを検討しましょう。月が1つズレるバグが生まれるのは、だいたいあの手の文字列結合です。

JavaScriptで日付を比較する

同じ時刻を表す2つの Date オブジェクトでも、=== での比較は等しくなりません。=== は値ではなくオブジェクトの同一性を見ているからです。比較するときはタイムスタンプ同士を突き合わせましょう。

const a = new Date("2026-03-14T09:30:00Z");
const b = new Date("2026-03-14T09:30:00Z");

console.log(a === b);              // false
console.log(a.getTime() === b.getTime());  // true
console.log(+a === +b);            // true — 単項 + で数値に変換される

比較演算子は内部で数値に変換されるので、日付の大小比較にはそのまま使えます。

const earlier = new Date("2026-01-01");
const later = new Date("2026-06-01");

console.log(earlier < later);
console.log(later > earlier);

const differenceMs = later - earlier;
const differenceDays = differenceMs / (1000 * 60 * 60 * 24);
console.log(`${differenceDays} days apart`);

引き算をすれば、ミリ秒単位での差分が得られます。日数にしたいなら 1000 * 60 * 60 * 24 で割ってください。最初のうちは定数として書き出しておくといいでしょう。そのうち 86_400_000 を見ただけで「ああ、1日分だな」とわかるようになります。

JavaScript で日付を加算・減算する

addDays のようなメソッドは用意されていません。定石は setDate や setMonth などを使うことです。これらは範囲外の値を渡しても、ちゃんと繰り上がり・繰り下がりを処理してくれます。

function addDays(date, days) {
    const result = new Date(date);
    result.setDate(result.getDate() + days);
    return result;
}

const today = new Date("2026-03-14");
console.log(addDays(today, 7).toISOString());
console.log(addDays(today, 30).toISOString());
console.log(addDays(today, -5).toISOString());

特に押さえておきたいポイントが2つあります。

• new Date(date) は日付のコピーを作ります。setDate は元の値を書き換える（ミューテート）ので、先にコピーを取らないと呼び出し元の値まで変わってしまいます。
• 31日ある月に対して setDate(35) とすると、自動的に翌月へ繰り越されます。setMonth(14) も同様に、年が進みます。そのおかげで、見た目ほど日付の計算は面倒ではありません。

ただし、営業日の計算、繰り返しイベント、月をまたぐ期間といった込み入った処理には、ライブラリ（date-fns、Luxon、あるいは次世代の Temporal API）を使いましょう。「数日足す」程度を超えるカレンダー計算を自前で書き始めると、まず沼にはまります。

タイムゾーンのずれに要注意

JavaScript の日付処理でバグの温床となる最大の要因がタイムゾーンです。最低限これだけは頭に入れておきましょう。

• Date が内部で保持しているのは UTC の瞬間（インスタント）です。タイムゾーンが反映されるのは、値を取り出したりフォーマットしたりするタイミングだけです。
• getHours() や getDate() などが返す値は、コードを実行しているマシンの ローカル タイムゾーンに基づきます。サーバーとブラウザでここが食い違うことはよくあります。
• new Date("2026-03-14")（日付のみ）は UTC として解析されます。new Date("2026-03-14T00:00")（時刻あり・タイムゾーンなし）はローカルとして解析されます。new Date(2026, 2, 14)（各要素を渡す形式）もローカルです。

const fromString = new Date("2026-03-14");
const fromParts = new Date(2026, 2, 14);

console.log(fromString.toISOString());
console.log(fromParts.toISOString());

// これらはタイムゾーンによって数時間異なる場合があります。

表示用に特定のタイムゾーンを指定したい場合は、Intl.DateTimeFormat に timeZone を渡します。

const d = new Date("2026-03-14T09:30:00Z");

const tokyo = new Intl.DateTimeFormat("en-US", {
    dateStyle: "short",
    timeStyle: "short",
    timeZone: "Asia/Tokyo",
});
const nyc = new Intl.DateTimeFormat("en-US", {
    dateStyle: "short",
    timeStyle: "short",
    timeZone: "America/New_York",
});

console.log(tokyo.format(d));
console.log(nyc.format(d));

同じ瞬間を、異なる見え方で。Date オブジェクト自体は何も変わっていません。

実際に動かしてみる

ここまでの内容を組み合わせて、「どれくらい前に起きたか」を整形して表示する関数を書いてみましょう。

function timeAgo(date) {
    const seconds = Math.floor((Date.now() - date.getTime()) / 1000);
    if (seconds < 60) return `${seconds}秒前`;

    const minutes = Math.floor(seconds / 60);
    if (minutes < 60) return `${minutes}分前`;

    const hours = Math.floor(minutes / 60);
    if (hours < 24) return `${hours}時間前`;

    const days = Math.floor(hours / 24);
    return `${days}日前`;
}

const past = new Date(Date.now() - 3 * 60 * 60 * 1000);
console.log(timeAgo(past));

const older = new Date(Date.now() - 5 * 24 * 60 * 60 * 1000);
console.log(timeAgo(older));

タイムスタンプを受け取って、人間が読める文字列として返す。実務で書く日付コードの9割はこの形です。2つの瞬間を引き算して、単位で割り、丸めて、フォーマットする。

この章のまとめ

• Date はUTCの瞬間を表します。タイムゾーンが登場するのは、値を読み出すときやフォーマットするときだけです。
• タイムスタンプが欲しいときは Date.now()、カレンダー的な処理をしたいときは new Date() を使いましょう。
• 保存やログ出力には toISOString()、ユーザー向け表示には Intl.DateTimeFormat が定番です。
• 日付の比較は getTime() か < / > で。=== は絶対にNGです。
• 月は0始まりです。日付だけの文字列をパースするときの落とし穴にも注意。
• 本格的な日付計算をするなら、ライブラリに任せましょう。

次回:URLとクエリ文字列

日付はURLにもよく登場します。日付範囲で絞り込んだり、タイムスタンプをクエリパラメータとして渡したり。URLを手作業でパースしたり組み立てたりするのは、日付を手でフォーマットするのと同じくらいバグの温床です。標準ライブラリにはこれをきれいに扱える URL オブジェクトが用意されているので、次回はそれを見ていきます。