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

Date.prototype.setUTCFullYear()

setUTCFullYear() メソッドは、協定世界時に基づき、指定された日付の年を設定します。

構文

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

引数

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

戻り値

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

説明

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

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

setUTCFullYear() を使う

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

仕様

仕様書 策定状況 備考
ECMAScript 1st Edition (ECMA-262) 標準 初期定義。JavaScript 1.3 で実装。
ECMAScript 5.1 (ECMA-262)
Date.prototype.setUTCFullYear の定義
標準
ECMAScript 2015 (6th Edition, ECMA-262)
Date.prototype.setUTCFullYear の定義
標準
ECMAScript 2017 Draft (ECMA-262)
Date.prototype.setUTCFullYear の定義
ドラフト

ブラウザの実装状況

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

関連情報

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

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