Date.prototype.setMonth()

setMonth() メソッドは、現在設定されている年に基づき、指定された日付の「月」を設定します。

構文

dateObj.setMonth(monthValue[, dayValue])

JavaScript 1.3 以前のバージョン

dateObj.setMonth(monthValue)

引数

monthValue
1 月から 12 月までを表す 0 から 11 までの間の整数値。
dayValue
任意。「日」を表す 1 から 31 までの間の整数値。

戻り値

協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。

説明

dayValue 引数を指定しない場合、getDate() メソッドから返される値が使われます。

指定した値が期待される日付の範囲外の場合、それに応じて setMonth()Date オブジェクトの日付情報の更新を試みます。例えば、monthValue に 15 を指定した場合、年に 1 加算 (minutesValue + 1) され、月が 3 になります。

このメソッドの動作は、ある特定の月の日にちに影響を与えます。概念上は、その月の日数を、パラメータとして与えた新しい月の初日に加え、新しい日付を返します。例えば、現在の値が 2016 年 8 月 31 日である場合、1 を引数として setMonth を呼び出すと 2016 年 3 月 2 日が返ってきます。これは、2016 年 2 月が 29 日間しかないからです。

setMonth() を使う

var theBigDay = new Date();
theBigDay.setMonth(6);

仕様

仕様書 策定状況 備考
ECMAScript 1st Edition (ECMA-262) 標準 初期定義。JavaScript 1.0 で実装。
ECMAScript 5.1 (ECMA-262)
Date.prototype.setMonth の定義
標準
ECMAScript 2015 (6th Edition, ECMA-262)
Date.prototype.setMonth の定義
標準
ECMAScript (ECMA-262)
Date.prototype.setMonth の定義
現行の標準

ブラウザの実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
setMonthChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 3Opera 完全対応 3Safari 完全対応 1WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 0.1.100

凡例

完全対応  
完全対応

関連情報