JavaScript

：

：

Date.prototype.setUTCFullYear() メソッド

　編集：2022.12.05 by T.A.

[Edge]。→

Date に日時の「年」（オプションで「月」「日」も）を協定世界時に基づき設定します。

戻り値として、更新後の日時の、協定世界時（UTC）での 1970 年 1 月 1 日 0 時 0 分 0 秒からのミリ秒単位の数値を返します。

構文
Date.setUTCFullYear(yearValue[, monthValue[, dayValue]])
Date Date。
yearValue 「年」を表す整数値。例えば、1995。
monthValue 省略可。「月」を表す整数値（0～11（1月～12月））。これ以外の値は計算されて増減して設定されます。
dayValue 省略可。「日」を表す整数値（1～31）。これ以外の値は計算されて増減して設定されます。
返値

更新後の日時の、協定世界時（UTC）での 1970 年 1 月 1 日 0 時 0 分 0 秒からのミリ秒単位の数値。

解説／mdn

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

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

例
／mdn
var theBigDay = new Date();
D=theBigDay.setUTCFullYear(1997); //＝870872462027

DA=new Date('2020-10-05');  //2020年10月5日。
T=DA.setUTCFullYear(1997);  //1997年で設定。＝[number]：876009600000
DO=new Date(T);
D=DO.toISOString();  //＝[string]：1997-10-05T00:00:00.000Z

T=DA.setUTCFullYear(2020, -1);  //2020年1月の-1月で設定。
DO=new Date(T);
D=DO.toISOString();  //＝[string]：2019-12-05T00:00:00.000Z
テスト