n か月後の日付

ここではオフィススクリプトを使って、1 か月後や n か月後の日付を求める方法を、サンプルコードと併せて解説します。

VBA との違い: 月末の日付が翌々月にずれる

VBA のDateAdd関数や Excel のEDATE関数は、加算した結果が存在しない日付になる場合、その月の末日に合わせます。例えばDateAdd("m", 1, #1/31/2024#)は 2024 年 2 月 29 日を返します。

一方、Office スクリプトでDateオブジェクトのsetMonthメソッドを使って月を加算すると、存在しない日付の超えた分は さらに次の月に繰り越されます。2024 年 1 月 31 日の 1 か月後は「2 月 31 日」となり、2 月の末日(29 日)を超えた 2 日分が 3 月に繰り越されて 2024 年 3 月 2 日になります。

setMonth で月を加算する

DateオブジェクトのgetMonthメソッドで現在の月を取得し、加算した値をsetMonthメソッドに渡します。

1か月後の日付を求めるサンプル

function main(workbook: ExcelScript.Workbook) {
  const date = new Date(2024, 3, 15); // 2024 年 4 月 15 日

  date.setMonth(date.getMonth() + 1);

  console.log(date.toLocaleDateString()); // 2024/5/15
}

12 月に月を加算した場合も、自動的に翌年に繰り上げられます。日付が 28 日以前であれば、この方法で問題ありません。

月末の日付に加算すると翌々月にずれる

元の日付が 29 日以降の場合、加算した先の月にその日が存在しないことがあります。

以下は 2024 年 1 月 31 日に 1 か月を加算した場合の例です。setMonth(1)で「2024 年 2 月 31 日」が指定されますが、2 月は 29 日までのため、超えた 2 日分が 3 月に繰り越されます。

日付や加える数を変えて、どのような場合にずれが起きるかを確かめてみましょう。

元の日付加える数

date.setMonth(date.getMonth() + 1)

1. 元の日付2024/1/31
2. setMonth(1) で指定した日付2024/2/31存在しない日付
3. 実際の日付2024/3/2

• 月は 0 から数えるため、0 は 1 月を表します。
• 2024 年 2 月は 29 日までのため、超えた 2 日分が翌月に繰り越されます。

日付や加える数を変えて、繰り上げのしかたを確かめてみましょう。

月を減算する場合も同じです。3 月 31 日の 1 か月前は「2 月 31 日」となり、2 月ではなく 3 月 2 日になります。

元の日付加える数

date.setMonth(date.getMonth() - 1)

1. 元の日付2024/3/31
2. setMonth(1) で指定した日付2024/2/31存在しない日付
3. 実際の日付2024/3/2

• 月は 0 から数えるため、2 は 3 月を表します。
• 2024 年 2 月は 29 日までのため、超えた 2 日分が翌月に繰り越されます。

日付や加える数を変えて、繰り上げのしかたを確かめてみましょう。

締め日や支払期日の計算でこのずれが起きると、1 か月以上先の日付として扱われてしまいます。

月末を超えないように加算する

VBA のDateAdd関数と同じく、存在しない日付になる場合は月の末日に合わせる関数を作成します。

nか月後の日付を求める関数

function main(workbook: ExcelScript.Workbook) {
  const date = new Date(2024, 0, 31); // 2024 年 1 月 31 日

  console.log(addMonths(date, 1).toLocaleDateString()); // 2024/2/29
  console.log(addMonths(date, 2).toLocaleDateString()); // 2024/3/31
  console.log(addMonths(date, 3).toLocaleDateString()); // 2024/4/30
  console.log(addMonths(date, -1).toLocaleDateString()); // 2023/12/31
}

/**
 * n か月後の日付を返す(存在しない日付になる場合は、その月の末日にする)
 * @param date 元の日付(変更されない)
 * @param months 加算する月数(負数なら n か月前)
 */
function addMonths(date: Date, months: number): Date {
  /** 加算した先の月の初日 */
  const firstDay = new Date(date.getFullYear(), date.getMonth() + months, 1);

  /** 加算した先の月の末日の「日」(翌月の 0 日) */
  const lastDay = new Date(firstDay.getFullYear(), firstDay.getMonth() + 1, 0).getDate();

  return new Date(firstDay.getFullYear(), firstDay.getMonth(), Math.min(date.getDate(), lastDay));
}

処理の流れは次のとおりです。

1. 加算した先の月の 初日 を作成します。1 日はどの月にも存在するため、ここでずれは起きません。
2. その月の末日を求めます(翌月の 0 日)。
3. 元の日付の「日」と月末の「日」のうち、小さい方を日として設定します。

月末日の求め方は、以下の記事で詳しく解説しています。

月末日・月初日の取得オフィススクリプトを使って、月末日や月初日、月の日数を Date オブジェクトで求める方法と、0 日を指定すると前月の末日になる仕組みを、サンプルコードと併せて解説します。

ノート

この関数は日付だけを扱うため、元の日付の時刻は引き継がれません(0 時 0 分になります)。

また、setMonthと違って元のDateオブジェクトを変更せず、新しいDateオブジェクトを返します。Dateオブジェクトは関数の中で変更されると呼び出し元にも影響するため、このように新しいオブジェクトを返すと安全です。

1 年後の日付

年を加算するsetFullYearメソッドでも、同じずれが起きます。うるう日(2 月 29 日)に 1 年を加算すると、翌年に 2 月 29 日が存在しないため 3 月 1 日になります。

元の日付加える数

date.setFullYear(date.getFullYear() + 1)

1. 元の日付2024/2/29
2. setFullYear(2025) で指定した日付2025/2/29存在しない日付
3. 実際の日付2025/3/1

• 2025 年 2 月は 28 日までのため、超えた 1 日分が翌月に繰り越されます。

日付や加える数を変えて、繰り上げのしかたを確かめてみましょう。

月末に合わせたい場合は、先ほどのaddMonths関数に 12 か月を指定します。

const leapDay = new Date(2024, 1, 29); // 2024 年 2 月 29 日

console.log(addMonths(leapDay, 12).toLocaleDateString()); // 2025/2/28

日付の操作現在の日付の取得や、日付の加算・減算、2つの日付の差を求める方法などを解説します。日付の体系的な操作方法について、サンプルコードと併せて解説します。