月末日・月初日の取得

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

月末日を取得する

Dateオブジェクトを作成するときに、年・月・日を指定します。日に0を指定すると、指定した月の前月の末日になります。

つまり「翌月の 0 日」を指定すると、その月の末日が求められます。

function main(workbook: ExcelScript.Workbook) {
  /** 現在の日付 */
  const now = new Date();

  /** 今月の末日(翌月の 0 日) */
  const endOfMonth = new Date(now.getFullYear(), now.getMonth() + 1, 0);

  console.log(endOfMonth.toLocaleDateString()); // 2026/11/30(現在が 2026 年 11 月の場合)
}

うるう年かどうかも自動的に考慮されます。

// 月の値 2 は 3 月を表すため、3 月の 0 日 = 2 月の末日になる
console.log(new Date(2024, 2, 0).toLocaleDateString()); // 2024/2/29
console.log(new Date(2023, 2, 0).toLocaleDateString()); // 2023/2/28

0 日が前月の末日になる仕組み

Dateオブジェクトは、存在しない日付が指定されると、自動的に繰り上げ(繰り下げ)を行います。

「1 日」の 1 日前である「0 日」は存在しないため、前月にさかのぼって前月の末日として扱われます。

以下は、3 月 1 日からsetDateで 1 日を引いた場合の例です。setDateに0が渡され、2 月 29 日になります。日付や加える数を変えて、繰り上げのしかたを確かめてみましょう。

元の日付加える数

date.setDate(date.getDate() - 1)

元の日付202431
setDate(0) で指定した日付202430存在しない日付
実際の日付2024229

0 日は前月の末日として扱われます。

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

new Date(2024, 2, 0)も同じく「2024 年 3 月 0 日」を指定しているため、2024 年 2 月 29 日になります。

12 月の翌月も自動で繰り上がる

12 月(getMonth()が11)に 1 を足すと月の値は12になりますが、これも存在しない月として翌年の 1 月に繰り上げられます。そのため、12 月の場合も特別扱いする必要はありません。

元の日付加える数

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

元の日付20241215
setMonth(12) で指定した日付20241315存在しない日付
実際の日付2025115

月は 0 から数えるため、11 は 12 月を表します。
13 月は存在しないため、2025 年 1 月として扱われます。

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

/** 2024 年 12 月の末日(2025 年 1 月 0 日 = 2024 年 12 月 31 日) */
console.log(new Date(2024, 11 + 1, 0).toLocaleDateString()); // 2024/12/31

月初日を取得する

月初日は、日に1を指定するだけで求められます。

const now = new Date();

/** 今月の初日 */
const startOfMonth = new Date(now.getFullYear(), now.getMonth(), 1);

前月・翌月の末日を取得する

月の値を変えることで、前月や翌月の末日も求められます。

const now = new Date();

/** 前月の末日(今月の 0 日) */
const endOfLastMonth = new Date(now.getFullYear(), now.getMonth(), 0);

/** 翌月の末日(翌々月の 0 日) */
const endOfNextMonth = new Date(now.getFullYear(), now.getMonth() + 2, 0);

月の日数を取得する

月末日の「日」は、その月の日数と同じです。getDateメソッドで取り出すと、月の日数として使えます。

function main(workbook: ExcelScript.Workbook) {
  /** 対象の年 */
  const year = 2024;

  for (let month = 0; month < 12; month++) {
    /** 月の日数(月末日の「日」) */
    const days = new Date(year, month + 1, 0).getDate();

    console.log(`${month + 1}月は${days}日まであります`);
  }
}

1月は31日まであります
2月は29日まであります
3月は31日まであります
…(中略)
12月は31日まであります

関数にまとめる

月末日を何度も使う場合は、関数にまとめておくと便利です。元のDateオブジェクトを変更せずに、新しいDateオブジェクトを返すようにしています。

function main(workbook: ExcelScript.Workbook) {
  const date = new Date(2024, 1, 10);

  console.log(getEndOfMonth(date).toLocaleDateString()); // 2024/2/29
  console.log(date.toLocaleDateString()); // 2024/2/10(元の日付は変わらない)
}

/** 指定した日付が属する月の末日を返す */
function getEndOfMonth(date: Date): Date {
  return new Date(date.getFullYear(), date.getMonth() + 1, 0);
}

n か月後の日付オフィススクリプトを使って、1 か月後や n か月後の日付を求める方法と、月末の日付に月を加算したときに翌々月にずれてしまう問題への対処法を、サンプルコードと併せて解説します。

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