【2026年7月最新】JavaScriptの日付取得・比較・フォーマット完全ガイド｜Date()の使い方からClaude Code活用まで

この記事の内容

1. 01JavaScriptのDateオブジェクト基本：現在日時の取得と主要メソッド
2. 02日付の比較方法：getTime()・比較演算子の使い方
3. 03日付差の計算：日数・時間・分のミリ秒計算
4. 04日付のフォーマット：YYYY-MM-DD・日本語形式に変換
5. 05よくあるバグと落とし穴：月は0始まり・タイムゾーン問題
6. 06実用的なDate活用パターン：昨日・明日・N日後の計算
7. 07Claude Codeで日付処理バグをデバッグする方法
8. FAQよくある質問

javascript

// 現在日時を取得
const now = new Date();
console.log(now); // Wed Jul 17 2026 10:30:00 GMT+0900 (JST)

// 特定の日時を指定して生成
const specific = new Date(2026, 6, 17); // 2026年7月17日（月は0始まり！）
const fromString = new Date('2026-07-17'); // ISO形式の文字列から
const fromTimestamp = new Date(1752710400000); // ミリ秒タイムスタンプから

// 年・月・日・時刻を個別に取得
const year = now.getFullYear();    // 2026
const month = now.getMonth() + 1;  // 7（0始まりなので+1が必要！）
const day = now.getDate();          // 17
const hour = now.getHours();        // 10
const minute = now.getMinutes();    // 30
const second = now.getSeconds();    // 0

📚 用語解説

Unix時刻（Unixタイムスタンプ）：1970年1月1日00:00:00 UTC（Coordinated Universal Time）からの経過ミリ秒数。Date.getTime()が返す値がこれにあたる。「2026-07-17T00:00:00Z」は数値で言うと約1752710400000ミリ秒。数値なので大小比較（>・<・===）が正確に機能するため、日付比較にはこの値を使うのが最も安全。

JavaScriptのgetMonth()は「0=1月、6=7月、11=12月」を返します。「7月17日」の月を取得したい場合、getMonth()の戻り値は「7」ではなく「6」です。表示する際は必ず+1してください。なお、new Date(年, 月, 日)でDateを生成する時も月は0始まりです。「new Date(2026, 7, 17)」は「7月17日」ではなく「8月17日」になります。

javascript

const date1 = new Date('2026-03-01');
const date2 = new Date('2026-11-15');

// 方法1: 比較演算子（< > は使える）
console.log(date1 < date2);  // true（date1が過去）
console.log(date1 > date2);  // false

// 方法2: getTime()でms変換してから比較（最も確実）
console.log(date1.getTime() < date2.getTime());  // true
console.log(date1.getTime() === date2.getTime()); // false

// 注意: == や === はオブジェクト参照比較になるため使えない
const d1 = new Date('2026-07-17');
const d2 = new Date('2026-07-17');
console.log(d1 == d2);  // false（同じ日付でも別オブジェクト）
console.log(d1.getTime() === d2.getTime()); // true（正しい比較）

📚 用語解説

参照比較 vs 値比較：JavaScriptでオブジェクト（Date・Array・Object等）を==や===で比較すると、「同じオブジェクトを指しているか（参照比較）」が行われる。「同じ内容か（値比較）」ではない。そのため同じ日付を表す2つのDateオブジェクトを==で比較するとfalseになる。プリミティブ型（数値・文字列・真偽値）は値比較が行われるため、getTime()で数値に変換してから===比較することで正確な日付の等価判定ができる。

javascript

const date1 = new Date('2026-01-01');
const date2 = new Date('2026-07-17');

// ミリ秒の差を計算
const diffMs = date2.getTime() - date1.getTime();
// diffMs = 197 * 24 * 60 * 60 * 1000 = 17020800000

// 日数に変換
const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
console.log(diffDays); // 197（日）

// 時間に変換
const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
console.log(diffHours); // 4728（時間）

// 分に変換
const diffMinutes = Math.floor(diffMs / (1000 * 60));
console.log(diffMinutes); // 283680（分）

// 「何日何時間何分」の表示
const days = Math.floor(diffMs / (1000 * 60 * 60 * 24));
const hours = Math.floor((diffMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
const minutes = Math.floor((diffMs % (1000 * 60 * 60)) / (1000 * 60));
console.log(`${days}日${hours}時間${minutes}分`); // 197日0時間0分

日本（JST）は夏時間がないためこの問題は少ないですが、アメリカ・ヨーロッパなどのサマータイムがある地域では1日の長さが23時間または25時間になる日があります。Dateオブジェクトはタイムゾーンを考慮した実際の時刻を扱うため、サマータイムをまたぐ日付差の計算では誤差が生じることがあります。グローバルアプリケーションではdayjsやdate-fnsなどのライブラリの使用を検討してください。

📚 用語解説

ミリ秒（Millisecond）：1秒の1,000分の1。コンピュータの時刻計算では「1970年1月1日0時0分0秒（UTC）からのミリ秒数」（Unixタイムスタンプ）が標準的に使われる。JavaScriptのDate.getTime()もミリ秒を返す。ミリ秒で扱うことで、日付・時刻を整数（Int64）として精確に比較・計算できる。

javascript

const now = new Date();

// YYYY-MM-DD形式（ゼロ埋め付き）
function formatDate(date) {
  const y = date.getFullYear();
  const m = String(date.getMonth() + 1).padStart(2, '0'); // 2桁ゼロ埋め
  const d = String(date.getDate()).padStart(2, '0');
  return `${y}-${m}-${d}`;
}
console.log(formatDate(now)); // 2026-07-17

// 日本語形式
function formatDateJP(date) {
  return `${date.getFullYear()}年${date.getMonth() + 1}月${date.getDate()}日`;
}
console.log(formatDateJP(now)); // 2026年7月17日

// ISO 8601形式（UTCタイムゾーン）
console.log(now.toISOString()); // 2026-07-17T01:30:00.000Z

// Intl.DateTimeFormat（ロケール対応）
const jpFormatter = new Intl.DateTimeFormat('ja-JP', {
  year: 'numeric', month: 'long', day: 'numeric', weekday: 'long'
});
console.log(jpFormatter.format(now)); // 2026年7月17日木曜日

「07」「03」のように2桁固定で表示したい場合、String(value).padStart(2, "0") が便利です。「getMonth() + 1」の結果が1桁の場合も2桁にそろえてくれます。例: String(7).padStart(2, "0") → "07"。

javascript

// バグ例1: 月は0始まりのミス
const wrong = new Date(2026, 7, 1); // 8月1日になってしまう！
const correct = new Date(2026, 6, 1); // 7月1日（正しい）

// バグ例2: ISO文字列のタイムゾーン問題
const d1 = new Date("2026-07-17"); // UTC午前0時として解釈 → JSTでは前日の23:00
const d2 = new Date("2026-07-17T00:00:00+09:00"); // JST指定で正しい

// バグ例3: 文字列比較の罠
"2024-3-1" > "2024-11-15" // true（文字コードで"3" > "1"なので誤り）
new Date("2024-3-1").getTime() > new Date("2024-11-15").getTime() // false（正しい）

// 正しいうるう年対応の日付加算
const today = new Date();
today.setDate(today.getDate() + 30); // 30日後（うるう年も自動対応）

javascript

const today = new Date();

// 昨日
const yesterday = new Date(today);
yesterday.setDate(today.getDate() - 1);

// 明日
const tomorrow = new Date(today);
tomorrow.setDate(today.getDate() + 1);

// N日後
function addDays(date, n) {
  const result = new Date(date);
  result.setDate(date.getDate() + n);
  return result;
}
const after30days = addDays(today, 30);
const before7days = addDays(today, -7);

// 月初・月末
const firstDayOfMonth = new Date(today.getFullYear(), today.getMonth(), 1);
const lastDayOfMonth = new Date(today.getFullYear(), today.getMonth() + 1, 0);
// getMonth() + 1（翌月）の「0日目」= 今月の末日

// 今年の残り日数
const endOfYear = new Date(today.getFullYear(), 11, 31); // 12月31日（月は0始まり）
const remainingDays = Math.ceil(
  (endOfYear.getTime() - today.getTime()) / (1000 * 60 * 60 * 24)
);

// 曜日を日本語で取得
const weekdays = ["日", "月", "火", "水", "木", "金", "土"];
const weekday = weekdays[today.getDay()];
console.log(`本日は${weekday}曜日`);

setDate(today.getDate() + 30)のように月をまたぐ日数を加算しても、JavaScriptが自動的に翌月・翌年の正しい日付に変換してくれます。「1月31日 + 1日」はsetDate(32)になりますが、自動的に2月1日として処理されます。

📚 用語解説

うるう年（閏年 / Leap Year）：2月が29日になる年。グレゴリオ暦では「4で割り切れる年はうるう年。ただし100で割り切れる年は平年。ただし400で割り切れる年はうるう年」というルールで決まる。2024年・2028年はうるう年、2100年・2200年・2300年は平年（400で割り切れないため）。JavaScriptのsetDate()やnew Date(年, 月, 日)はうるう年を自動考慮するが、手動で日付計算する場合はうるう年判定ロジックが必要。

📚 用語解説

ISO 8601：日付・時刻の国際標準表記形式。「YYYY-MM-DDTHH:mm:ss.sssZ」の形式で表現される。末尾のZはUTC（協定世界時）を意味し、+09:00のようなオフセットで他のタイムゾーンも表現できる。JavaScriptのDate.toISOString()はISO 8601形式の文字列を返す。APIのリクエスト・レスポンスでは基本的にこの形式を使うことで、タイムゾーンの誤解が生じにくくなる。

複雑な日付操作（繰り返し予定の計算・タイムゾーン変換・国際化表示など）が必要な場合は、バンドルサイズが約2KBのday.jsか、ツリーシェイク対応のdate-fnsを使うことをお勧めします。標準のDateオブジェクトより遥かに少ないコードで複雑な処理が書けます。

NEXT STEP

この記事の内容を、あなたのビジネスで
実践してみませんか？