Date.prototype.setFullYear()

setFullYear() メソッドは、地方時に基づき、指定された日付の「年」を設定します。新しいタイムスタンプを返します。

構文

dateObj.setFullYear(yearValue[, monthValue[, dateValue]])

引数

yearValue
「年」の数字を指定する整数値。例えば、1995。
monthValue Optional
1 月から 12 月を表す 0 から 11 までの間の整数値。
dateValue Optional
「日」を表す 1 から 31 までの間の整数値。dayValue 引数を指定した場合、monthValue も指定しなければなりません。

戻り値

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

説明

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

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

setFullYear() を使う

var theBigDay = new Date();
theBigDay.setFullYear(1997);

仕様

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

ブラウザの実装状況

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

凡例

完全対応  
完全対応

関連情報