MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Date.prototype.setFullYear()

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

構文

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

引数

yearValue
「年」の数字を指定する整数値。例えば、1995。
monthValue
任意。1 月から 12 月を表す 0 から 11 までの間の整数値。
dayValue
任意。「日」を表す 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 2017 Draft (ECMA-262)
Date.prototype.setFullYear の定義
ドラフト

ブラウザの実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) (有) (有) (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: Marsf, shide55
 最終更新者: Marsf,