【JavaScript】日付を操作する方法｜加算・減算・比較・差分計算・月末取得・曜日判定・Date の set 系メソッドまで解説

const date = new Date("2026-03-31T10:30:00");

date.setFullYear(2027);
console.log(date); // 2027-03-31

date.setMonth(0);  // 1月（0始まり注意）
console.log(date); // 2027-01-31

date.setDate(15);
console.log(date); // 2027-01-15

date.setHours(9, 0, 0, 0); // 09:00:00.000
console.log(date); // 2027-01-15T09:00:00

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

const today = new Date("2026-03-31");
console.log(addDays(today, 7));   // 2026-04-07（7日後）
console.log(addDays(today, -3));  // 2026-03-28（3日前）
console.log(addDays(today, 365)); // 2027-03-31（1年後）

function addMonths(date, months) {
  const result = new Date(date);
  result.setMonth(result.getMonth() + months);
  return result;
}

console.log(addMonths(new Date("2026-01-31"), 1));
// 2026-03-03（1月31日の1月後 → 2月31日は存在しないため3月3日に繰り上がり）

function addMonthsSafe(date, months) {
  const result = new Date(date);
  const targetMonth = result.getMonth() + months;
  result.setMonth(targetMonth);

  // 月が想定と異なる場合は月末日に補正
  if (result.getMonth() !== ((targetMonth % 12) + 12) % 12) {
    result.setDate(0); // 前月の末日に戻す
  }
  return result;
}

console.log(addMonthsSafe(new Date("2026-01-31"), 1));
// 2026-02-28（2月の末日に補正）

function addYears(date, years) {
  const result = new Date(date);
  result.setFullYear(result.getFullYear() + years);
  return result;
}

console.log(addYears(new Date("2024-02-29"), 1));
// 2025-03-01（うるう年2/29の1年後は3/1に繰り上がり）

const date1 = new Date("2026-03-01");
const date2 = new Date("2026-04-15");

// 比較演算子で直接比較可能
console.log(date1 < date2);  // true（date1 が先）
console.log(date1 > date2);  // false

// getTime() で数値比較も可能
console.log(date1.getTime() < date2.getTime()); // true

const a = new Date("2026-03-31");
const b = new Date("2026-03-31");

// NG: === ではオブジェクトの参照が異なるため false
console.log(a === b); // false

// OK: getTime() で数値比較
console.log(a.getTime() === b.getTime()); // true

// 日付のみ（時刻を無視して）比較する場合
function isSameDate(d1, d2) {
  return d1.getFullYear() === d2.getFullYear()
    && d1.getMonth() === d2.getMonth()
    && d1.getDate() === d2.getDate();
}
console.log(isSameDate(a, b)); // true

const start = new Date("2026-03-01");
const end = new Date("2026-04-15");

// ミリ秒の差分
const diffMs = end - start;

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

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

function dateDiff(start, end) {
  const ms = Math.abs(end - start);
  return {
    days:    Math.floor(ms / (1000 * 60 * 60 * 24)),
    hours:   Math.floor((ms % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60)),
    minutes: Math.floor((ms % (1000 * 60 * 60)) / (1000 * 60)),
    seconds: Math.floor((ms % (1000 * 60)) / 1000)
  };
}

console.log(dateDiff(
  new Date("2026-03-31T10:00:00"),
  new Date("2026-04-02T15:30:45")
));
// { days: 2, hours: 5, minutes: 30, seconds: 45 }

function getLastDay(year, month) {
  // month は 1始まり（1月=1）で受け取る
  return new Date(year, month, 0).getDate();
}

console.log(getLastDay(2026, 2));  // 28（2月）
console.log(getLastDay(2024, 2));  // 29（うるう年の2月）
console.log(getLastDay(2026, 4));  // 30（4月）
console.log(getLastDay(2026, 12)); // 31（12月）

const dayNames = ["日", "月", "火", "水", "木", "金", "土"];

const date = new Date("2026-03-31");
console.log(dayNames[date.getDay()]); // "火"

// toLocaleDateString で曜日を含めたフォーマット
console.log(date.toLocaleDateString("ja-JP", {
  year: "numeric", month: "long", day: "numeric", weekday: "long"
}));
// "2026年3月31日火曜日"

function isLeapYear(year) {
  return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
}

console.log(isLeapYear(2024)); // true
console.log(isLeapYear(2026)); // false
console.log(isLeapYear(2000)); // true（400の倍数）
console.log(isLeapYear(1900)); // false（100の倍数だが400の倍数ではない）

// Date を使った別解（2月29日が存在するか）
function isLeapYear2(year) {
  return new Date(year, 1, 29).getDate() === 29;
}
console.log(isLeapYear2(2024)); // true

function isValidDate(year, month, day) {
  const date = new Date(year, month - 1, day);
  return date.getFullYear() === year
    && date.getMonth() === month - 1
    && date.getDate() === day;
}

console.log(isValidDate(2026, 2, 28));  // true
console.log(isValidDate(2026, 2, 29));  // false（うるう年でない）
console.log(isValidDate(2026, 13, 1));  // false（13月は存在しない）

function isWithinPeriod(start, end) {
  const now = new Date();
  return now >= new Date(start) && now <= new Date(end);
}

console.log(isWithinPeriod("2026-01-01", "2026-12-31"));
// true（2026年内なら）

function addBusinessDays(date, days) {
  const result = new Date(date);
  let added = 0;

  while (added < days) {
    result.setDate(result.getDate() + 1);
    const day = result.getDay();
    if (day !== 0 && day !== 6) { // 土日を除く
      added++;
    }
  }
  return result;
}

// 2026-03-31（火）の5営業日後
console.log(addBusinessDays(new Date("2026-03-31"), 5));
// 2026-04-07（火）（4/4土, 4/5日をスキップ）