このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Date.prototype.setDate()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
setDate() はDate インスタンスのメソッドで、地方時に基づいてこの日時の月内の日を変更します。
試してみましょう
const event = new Date("August 19, 1975 23:15:30");event.setDate(24);console.log(event.getDate());// 予想される結果: 24event.setDate(32);// Only 31 days in August!console.log(event.getDate());// 予想される結果: 1構文
js
setDate(dateValue)引数
dateValue月内の「日」を表す整数の値です。
返値
その場でDate オブジェクトを変更し、新しいタイムスタンプを返します。dateValue がNaN （またはundefined など、NaN に変換されるその他の値）の場合、日付は無効な日時に設定され、NaN が返されます。
解説
指定した数値が指定した範囲外の場合、Date オブジェクトの日付情報がそれに応じて更新されます。例えば、Date オブジェクトが 6 月 1 日を保持している場合、dateValue を 40 に変更すると日付は 7 月 10 日になり、dateValue を 0 に変更すると日付は前月の最終日である 5 月 31 日になります。
例
setDate() の使用
js
const theBigDay = new Date(1962, 6, 7, 12); // 1962-07-07 正午（月は 0 起点）const theBigDay2 = new Date(theBigDay).setDate(24); // 1962-07-24const theBigDay3 = new Date(theBigDay).setDate(32); // 1962-08-01const theBigDay4 = new Date(theBigDay).setDate(22); // 1962-07-22const theBigDay5 = new Date(theBigDay).setDate(0); // 1962-06-30const theBigDay6 = new Date(theBigDay).setDate(98); // 1962-10-06const theBigDay7 = new Date(theBigDay).setDate(-50); // 1962-05-11仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setdate |